MapGenericMask function (securitybaseapi.h)

Article
10/13/2021

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.

Syntax

void MapGenericMask(
  [in, out] PDWORD           AccessMask,
  [in]      PGENERIC_MAPPING GenericMapping
);

Parameters

[in, out] AccessMask

A pointer to an access mask.

[in] GenericMapping

A pointer to a GENERIC_MAPPING structure specifying a mapping of generic access types to specific and standard access types.

Return value

None

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.

Examples

For an example that uses this function, see Verifying Client Access with ACLs.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	securitybaseapi.h (include Windows.h)
Library	Advapi32.lib
DLL	Advapi32.dll