MapGenericMask function

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 WINAPI MapGenericMask(
  _Inout_ PDWORD           AccessMask,
  _In_    PGENERIC_MAPPING GenericMapping
);

Parameters

AccessMask [in, out]

A pointer to an access mask.

GenericMapping [in]

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

Return value

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.

Examples

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

Requirements

See also

Client/Server Access Control Overview

Client/Server Access Control Functions

AccessCheck

AreAllAccessesGranted

AreAnyAccessesGranted

GENERIC_MAPPING