ISecurityInformation::MapGeneric method

The MapGeneric method requests that the generic access rights in an access mask be mapped to their corresponding standard and specific access rights. For more information about generic, standard, and specific access rights, see Access Rights and Access Masks.

Syntax


HRESULT MapGeneric(
  [inconst GUID        *pguidObjectType,
  [in]       UCHAR       *pAceFlags,
  [in]       ACCESS_MASK *pMask
);

Parameters

pguidObjectType [in]

A pointer to a GUID structure that identifies the type of object to which the access mask applies. If this member is NULL or a pointer to GUID_NULL, the access mask applies to the object itself.

pAceFlags [in]

A pointer to the AceFlags member of the ACE_HEADER structure from the ACE whose access mask is being mapped.

pMask [in]

A pointer to an access mask that contains the generic access rights to map. Your implementation must map the generic access rights to the corresponding standard and specific access rights for the specified object type.

Return value

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

Your MapGeneric implementation can call the MapGenericMask function to map the generic access rights in the access mask.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Aclui.h

See also

ISecurityInformation
Access Control Editor
Access Control Editor Functions
ACE_HEADER
CreateSecurityPage
EditSecurity
GUID
MapGenericMask

 

 

Show: