AreAnyAccessesGranted-Funktion (securitybaseapi.h)

Artikel
03/01/2024

Die Funktion AreAnyAccessesGranted testet , ob einer der angeforderten Zugriffsrechte erteilt wurde. Die Zugriffsrechte werden als Bitflags in einer Zugriffsmaske dargestellt.

Syntax

BOOL AreAnyAccessesGranted(
  [in] DWORD GrantedAccess,
  [in] DWORD DesiredAccess
);

Parameter

[in] GrantedAccess

Gibt die gewährte Zugriffsmaske an.

[in] DesiredAccess

Gibt die zugriffsmaske an, die angefordert werden soll. Diese Maske muss von generischen zu spezifischen Und Standardzugriffsrechten zugeordnet worden sein, in der Regel durch Aufrufen der MapGenericMask-Funktion .

Rückgabewert

Wenn eines der angeforderten Zugriffsrechte erteilt wurde, ist der Rückgabewert nichtzero.

Wenn keine der angeforderten Zugriffsrechte erteilt wurde, ist der Rückgabewert 0.

Hinweise

Die AreAnyAccessesGranted-Funktion wird häufig von einer Serveranwendung verwendet, um die Zugriffsrechte eines Clients zu überprüfen, der versucht, Zugriff auf ein Objekt zu erhalten. Wenn eines der im DesiredAccess-Parameter festgelegten Bits mit den im GrantedAccess-Parameter festgelegten Bits übereinstimmt, wurde mindestens eine der angeforderten Zugriffsrechte erteilt.

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ßlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll