ISecurityInfo::GetPermissions

Returns the available permissions for a given object type.

The provider sets the appropriate bits in an ACCESS_MASK structure to identify the permissions for any trustee that can possibly be set on the object type given in ObjectType.

HRESULT GetPermissions ( 
   GUID              ObjectType,
   ACCESS_MASK *     pPermissions
);

Parameters

ObjectType

[in]
The GUID of the object type for which permissions are being obtained.

pPermissions

[out]
Address of an ACCESS_MASK structure that receives the permissions supported for the object.

Return Code

S_OK

The available permissions were successfully retrieved.

SEC_E_PERMISSIONDENIED

Requester does not have permissions for the operation.

SEC_E_INVALIDOBJECT

The object that was supplied is invalid or unknown to the provider.

E_INVALIDARG

pPermissions was a null pointer.

E_FAIL

A provider-specific error occurred.

Comments

The GUID in ObjectType can be either a standard object type GUID or a provider-specific GUID for nonstandard objects types.