This Method is used to remove a Role from the RoleSet Object.
The RoleNodeId is the NodeId of the Role Object to remove.
The Server may prohibit the removal of some Roles because they are necessary for the Server to function.
If a Role is removed all Permissions associated with the Role shall be deleted. Ideally these changes should take effect immediately; however, some lag may occur.
The Client shall use an encrypted channel and shall provide user credentials with administrator rights like SecurityAdmin Role when invoking this Method on the Server.
Signature
RemoveRole (
[in]NodeId RoleNodeId
);
|
Argument |
Description |
|
RoleNodeId |
The NodeId of the Role Object. |
Method Result Codes
|
ResultCode |
Description |
|
Bad_NodeIdUnknown |
|
|
Bad_NotSupported |
The Server does not allow the Role Object to be removed. |
|
Bad_UserAccessDenied |
The caller does not have the necessary Permissions. |
|
Bad_SecurityModeInsufficient |
The SecureChannel is not encrypted. |
|
Bad_RequestNotAllowed |
The specified Role Object cannot be removed. |
The RemoveRole Method representation in the AddressSpace is formally defined in Table 3.
Table 3 – RemoveRole Method AddressSpace definition
|
Attribute |
Value |
||||
|
BrowseName |
RemoveRole |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
|
0:HasProperty |
Variable |
0:InputArguments |
0:Argument[] |
0:PropertyType |
M |
|
ConformanceUnits |
|||||
|
Security Role Server Management |
|||||