ISecurityInformation::MapGeneric method (aclui.h)

Article
02/22/2024

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(
  [in] const GUID  *pguidObjectType,
  [in] UCHAR       *pAceFlags,
  [in] ACCESS_MASK *pMask
);

Parameters

[in] pguidObjectType

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.

[in] pAceFlags

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

[in] pMask

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

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	aclui.h