ISecurityInformation::MapGeneric

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.

HRESULT MapGeneric(
  const GUID *pguidObjectType,
  UCHAR *pAceFlags,
  ACCESS_MASK *pMask
);

Parameters

pguidObjectType

[in] 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] Pointer to the AceFlags member of the ACE_HEADER structure from the ACE whose access mask is being mapped.

pMask

[in] Pointer to an access mask containing the generic access rights to map. Your implementation should map the generic access rights to the corresponding standard and specific access rights for the specified object type.

Return Values

Return S_OK if successful.

Return a nonzero error code if an error occurs.

Remarks

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Aclui.h.

See Also

Access Control Editor Overview, Access Control Editor Interfaces, ACE_HEADER, CreateSecurityPage, EditSecurity, GUID, MapGenericMask