Public Overloads Function AddGroup( _
   ByVal groupName As String, _
   ByVal setActive As Boolean, _
   ByVal requestedUpdateRate As Integer, _
   ByRef percentDeadband As Single, _
   ByVal localeID As Integer, _
   ByVal ClientHandle As Integer, _
   ByRef err As Integer _
) As OpcGroup

public OpcGroup AddGroup( 
   string groupName,
   bool setActive,
   int requestedUpdateRate,
   ref float percentDeadband,
   int localeID,
   int ClientHandle,
   out int err
)

Parameters

groupName

Name of the new group. The name must be unique among the other groups created by this client. If the name is en empty string ("") then the server will generate a unique name. The server generated name will also be unique relative to any existing public groups.

setActive

Initial active state. true for active and false for inactive.

requestedUpdateRate

Client specifies the fastest rate at which data changes may be sent to OnDataChange for items in this group. This also indicates the desired accuracy of Cached Data. This is intended only to control the behavior of the interface. How the server deals with the update rate and how often it actually polls the hardware internally is an implementation detail. Passing 0 indicates the server should use the fastest practical rate. The rate is specified in milliseconds.

percentDeadband

IN: DeadBand value in %

localeID

IN: requested LocalId or 0

ClientHandle

Client provided handle for this group. The client handle is returned in asynchronous data callback to enable the client to identify the data.

err

OUT: HRESULT error/success code

Return Value

Target Platforms: Windows 7/8/10, Windows Server 2003/2008/2012/2016, .NET 4.x

See Also