uaPLUS Reference
DlgStartPlugin Delegate
See Also  Send Feedback
Advosol.uaPLUS Namespace : DlgStartPlugin Delegate

updatePeriod
This interval in ms is used by the generic server as the fastest possible client update rate and also uses this definition when determining the refresh need if no client defined a sampling rate for the item.
The default value is as defined in the wizard dialog. In the DANSrv.exe.config the value is defined as:
<add key="UpdatePeriod" value = "100" />
browseMode

Defines how client browse calls are handled.
0 (real mode) : all browse calls are handled in the generic server according the items defined in the server cache.
2 (virtual mode) : all client browse calls are handled in this plug-in and typically return the items that are or could be dynamically added to the server cache.
Only the DANSrv/XDARap Professional Edition supports virtual mode browsing. The Standard Edition ignores this parameter.

The default value is as defined in the wizard dialog. In the file DANSrv.exe.config respectively web.config the value is defined as:
<add key="BrowseMode" value = "REAL" /> <!-- REAL or VIRTUAL -->

validateMode

This parameter controls how the generic server handles the ValidateItems client calls.
0 : The plug-in ValidateItems method is called for items that are not found in the generic server cache.
1 : The plug-in ValidateItems method is NEVER called. Requested items that are not defined in the generic server cache are treated as unknown items.
2 : The plug-in ValidateItems method is ALWAYS called. This allows the plug-in to determine the items access rights based on the client's credentials and return OPC_E_UNKNOWNITEMID for clients without the required privileges.

Only the DANSrv Professional Edition supports item validation and a dynamic address space. The DANSrv Standard Edition ignores this parameter.

The default value is as defined in the wizard dialog. In the file DANSrv.exe.config respectively web.config the value is defined as:
<add key="ValidateMode" value= "NEVER" /> <!-- NEVER, UNKNOWNITEMS or ALWAYS -->

branchDelemitter

Character is used as the branch/item separator character in fully qualified item names. It is typically '.' or '/'.
This character must match the character used in the fully qualified item IDs specified in the AddItems method call.

The default value is as defined in the wizard dialog. In the file DANSrv.exe.config respectively web.config the value is defined as:
<add key="BranchDelemitter" value= "." />

Glossary Item Box

This method is called at server startup to start the plug-in execution.

Syntax

Visual Basic (Declaration) 
Public Delegate Sub DlgStartPlugin( _
   ByRef updatePeriod As Integer, _
   ByRef browseMode As Integer, _
   ByRef validateMode As Integer, _
   ByRef branchDelemitter As Char _
) 
C# 
public delegate void DlgStartPlugin( 
   out int updatePeriod,
   out int browseMode,
   out int validateMode,
   out char branchDelemitter
)

Parameters

updatePeriod
This interval in ms is used by the generic server as the fastest possible client update rate and also uses this definition when determining the refresh need if no client defined a sampling rate for the item.
The default value is as defined in the wizard dialog. In the DANSrv.exe.config the value is defined as:
<add key="UpdatePeriod" value = "100" />
browseMode

Defines how client browse calls are handled.
0 (real mode) : all browse calls are handled in the generic server according the items defined in the server cache.
2 (virtual mode) : all client browse calls are handled in this plug-in and typically return the items that are or could be dynamically added to the server cache.
Only the DANSrv/XDARap Professional Edition supports virtual mode browsing. The Standard Edition ignores this parameter.

The default value is as defined in the wizard dialog. In the file DANSrv.exe.config respectively web.config the value is defined as:
<add key="BrowseMode" value = "REAL" /> <!-- REAL or VIRTUAL -->

validateMode

This parameter controls how the generic server handles the ValidateItems client calls.
0 : The plug-in ValidateItems method is called for items that are not found in the generic server cache.
1 : The plug-in ValidateItems method is NEVER called. Requested items that are not defined in the generic server cache are treated as unknown items.
2 : The plug-in ValidateItems method is ALWAYS called. This allows the plug-in to determine the items access rights based on the client's credentials and return OPC_E_UNKNOWNITEMID for clients without the required privileges.

Only the DANSrv Professional Edition supports item validation and a dynamic address space. The DANSrv Standard Edition ignores this parameter.

The default value is as defined in the wizard dialog. In the file DANSrv.exe.config respectively web.config the value is defined as:
<add key="ValidateMode" value= "NEVER" /> <!-- NEVER, UNKNOWNITEMS or ALWAYS -->

branchDelemitter

Character is used as the branch/item separator character in fully qualified item names. It is typically '.' or '/'.
This character must match the character used in the fully qualified item IDs specified in the AddItems method call.

The default value is as defined in the wizard dialog. In the file DANSrv.exe.config respectively web.config the value is defined as:
<add key="BranchDelemitter" value= "." />

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

© 2010-2018 Copyright Advosol Inc. All Rights Reserved.