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

Parameters

AccessMask

A pointer to an access mask.

GenericMapping

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

   
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

See Also

AccessCheck

AreAllAccessesGranted

AreAnyAccessesGranted

Client/Server Access Control Functions

Client/Server Access Control Overview

GENERIC_MAPPING