AuthzAccessCheckCallback-Rückruffunktion

Artikel
06/13/2023

Die AuthzAccessCheckCallback-Funktion ist eine anwendungsdefinierte Funktion, die Rückrufzugriffssteuerungseinträge (ACEs) während einer Zugriffsüberprüfung verarbeitet. AuthzAccessCheckCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen. Die Anwendung registriert diesen Rückruf, indem sie AuthzInitializeResourceManager aufruft.

Syntax

BOOL CALLBACK AuthzAccessCheckCallback(
  _In_     AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
  _In_     PACE_HEADER                 pAce,
  _In_opt_ PVOID                       pArgs,
  _Inout_  PBOOL                       pbAceApplicable
);

Parameter

hAuthzClientContext [in]

Ein Handle für einen Clientkontext.

pAce [in]

Ein Zeiger auf den ACE, der für die Aufnahme in den Aufruf der AuthzAccessCheck-Funktion ausgewertet werden soll.

pArgs [in, optional]

Daten, die im DynamicGroupArgs-Parameter des Aufrufs von AuthzAccessCheck oder AuthzCachedAccessCheck übergeben werden.

pbAceApplicable [in, out]

Ein Zeiger auf eine boolesche Variable, die die Ergebnisse der Auswertung der von der Anwendung definierten Logik empfängt.

Die Ergebnisse sind TRUE , wenn die Logik bestimmt, dass der ACE anwendbar ist und in den Aufruf von AuthzAccessCheck eingeschlossen wird. Andernfalls sind die Ergebnisse FALSE.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion TRUE zurück.

Wenn die Funktion die Auswertung nicht ausführen kann, gibt sie FALSE zurück. Verwenden Sie SetLastError , um einen Fehler an die Zugriffsüberprüfungsfunktion zurückzugeben.

Bemerkungen

Sicherheitsattributevariablen müssen im Clientkontext vorhanden sein, wenn sie in einem bedingten Ausdruck erwähnt werden. Andernfalls wird der bedingte Ausdrucksbegriff, der auf sie verweist, auf unbekannt ausgewertet.

Weitere Informationen finden Sie unter How AccessCheck Works and Centralized Authorization Policy overviews .For more information, see the How AccessCheck Works and Centralized Authorization Policy overviews.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Verteilbare Komponente	Windows Server 2003 Administration Tools Pack unter Windows XP

Siehe auch

Grundlegende Access Control-Funktionen
Zentralisierte Autorisierungsrichtlinie
Funktionsweise von AccessCheck
AuthzAccessCheck
AuthzCachedAccessCheck
AuthzInitializeRemoteResourceManager
AuthzInitializeResourceManager

Share via