Export (0) Print
Expand All
Expand Minimize

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Winbase.h (include Windows.h)

Library

Advapi32.lib

DLL

Advapi32.dll

See also

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft