IPermission
- Last UpdatedJun 12, 2017
- 1 minute read
IPermission provides read-only access to the properties of a single permission, including name, parent name, whether the permission is configured, if it has any children permissions, collection children permissions, whether it is a security group (root nodes in operation permission are). If the permission is a security group, IPermission can access the security group object.
Each role has two collections of permissions, a collection of general permissions and a collection of operational permissions, from which the client program can drill down to each sub-permission.
For example, for a role configured with the options shown in the sample Options dialog box, IPermission returns the following:
|
Operation |
What it returns |
|---|---|
|
PermissionName |
General Permission |
|
PermissionParentName |
Empty string |
|
IsConfigured |
Returns VARIANT_TRUE, or VARIANT_FALSE if any of its permission in the tree is configured |
|
HasChildren |
Returns VARIANT_TRUE |
|
ChildPermissions |
Returns the collection of IPermissions, which in this case is IDE Permissions and SMC Permissions |
|
IsASecurityGroup |
Returns VARIANT_FALSE. For "Operational Permissions" children, this property is VARIANT_TRUE. |
|
SecurityGroup |
Returns the ISecurityGroup object interface through which the user can access security group related properties. This property is valid for Operational Permission children. In other cases, this returns a NULL pointer. |
