This Method shall reassign Locks required by the ControlGroup in the ListToRestrict and ListToBlock. It shall reassign the SourceNode of the Controls Reference (see OPC 10000-23) to the controlling entity as defined by the LockContext.
It shall set Lock LockingClient to the LockContext Argument.
It is recommended that this Method be restricted to Client connections that have the well-known Role ConnectionAdmin as defined in Clause 5.9.
The signature of this Method is specified below; the arguments are defined in Table 67.
Signature
ReassignControl (
[in] 0:String LockContext,
[out] 0:Int32 LockStatus
);
Table 67 – ReassignControl Method Arguments
|
Argument |
Description |
|
LockContext |
A string used to provide context information about the lock-owner. It may be the NodeId (in string representation) of a ConnectionEndpoint or the ApplicationUri of a Client connection as provided in the CreateSession Service Call (see OPC 10000-4). It cannot be null. |
|
LockStatus |
0 – OK -1 – E_NotLocked – the Object is not locked -2 – E_Invalid – the element cannot be reassigned |
The possible Method result codes are formally defined in Table 68.
Table 68 – ReassignControl Method result codes
|
Result Code |
Description |
|
Bad_UserAccessDenied |
The caller is not allowed to reassign control on the ControlGroup. |
|
Bad_InvalidArgument |
LockContext was null, invalid, or non-existing. |
The ReassignControl Method representation in the AddressSpace is formally defined in Table 69.
Table 69 – ReassignControl Method AddressSpace definition
|
Attribute |
Value |
||||
|
BrowseName |
3:ReassignControl |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
|
0:HasProperty |
Variable |
0:InputArguments |
0:Argument[] |
0:PropertyType |
Mandatory |
|
0:HasProperty |
Variable |
0:OutputArguments |
0:Argument[] |
0:PropertyType |
Mandatory |
|
ConformanceUnits |
|||||
|
UAFX IFunctionalEntity ControlGroups |
|||||