MapGenericMask-Funktion (securitybaseapi.h)

Artikel
03/06/2024

Die MapGenericMask-Funktion ordnet die generischen Zugriffsrechte in einer Zugriffsmaske spezifischen und Standardzugriffsrechten zu. Die Funktion wendet eine Zuordnung an, die in einer GENERIC_MAPPING-Struktur bereitgestellt wird.

Syntax

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

Parameter

[in, out] AccessMask

Ein Zeiger auf eine Zugriffsmaske.

[in] GenericMapping

Ein Zeiger auf eine GENERIC_MAPPING-Struktur , die eine Zuordnung von generischen Zugriffstypen zu bestimmten und Standardzugriffstypen angibt.

Rückgabewert

Keine

Bemerkungen

Nach dem Aufrufen der MapGenericMask-Funktion ist für die Zugriffsmaske, auf die der AccessMask-Parameter verweist, keine generischen Bits (GenericRead, GenericWrite, GenericExecute oder GenericAll) oder nicht definierte Bits festgelegt, obwohl andere Bits festgelegt sein können. Wenn bei der Eingabe andere Bits als die generischen Bits bereitgestellt werden, löscht diese Funktion diese nicht.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Überprüfen des Clientzugriffs mit ACLs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (Einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll