MapGenericMask

The MapGenericMask function maps the generic access rights in an access mask to specific and standard access rights. The function applies a mapping supplied in a GENERIC_MAPPING structure.

VOID MapGenericMask(
  PDWORD AccessMask,               // access mask
  PGENERIC_MAPPING GenericMapping  // mapping
);

Parameters

AccessMask

[out] Pointer to an access mask receiving the specific and standard rights mapped from generic access rights.

GenericMapping

[in] Pointer to a GENERIC_MAPPING structure specifying a mapping of generic access types to specific and standard access types.

Return Values

This function does not return a value.

Remarks

After calling the MapGenericMask function, the access mask pointed to by the AccessMask parameter has none of its generic bits (GenericRead, GenericWrite, GenericExecute, or GenericAll) or undefined bits set, although it can have other bits set. If bits other than the generic bits are provided on input, this function does not clear them.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Advapi32.lib.

See Also

Client/Server Access Control Overview, Client/Server Access Control Functions, AccessCheck, AreAllAccessesGranted, AreAnyAccessesGranted, GENERIC_MAPPING