AUTHZ_ACCESS_REPLY-Struktur (authz.h)

Artikel
02/26/2024

Die AUTHZ_ACCESS_REPLY-Struktur definiert eine Zugriffsüberprüfungsantwort.

Syntax

typedef struct _AUTHZ_ACCESS_REPLY {
  DWORD        ResultListLength;
  PACCESS_MASK GrantedAccessMask;
  PDWORD       SaclEvaluationResults;
  PDWORD       Error;
} AUTHZ_ACCESS_REPLY, *PAUTHZ_ACCESS_REPLY;

Member

ResultListLength

Die Anzahl der Elemente in den Arrays GrantedAccessMask, SaclEvaluationResults und Error . Diese Zahl entspricht der Anzahl der Einträge in der Objekttyplistenstruktur, die bei der Zugriffsprüfung verwendet wird. Wenn kein Objekttyp verwendet wird, um das Objekt darzustellen, legen Sie ResultListLength auf eins fest.

GrantedAccessMask

Ein Array von gewährten Zugriffsmasken. Arbeitsspeicher für dieses Array wird von der Anwendung zugewiesen, bevor AccessCheck aufgerufen wird.

SaclEvaluationResults

Ein Array von SACL-Auswertungsergebnissen ( System Access Control List ) Arbeitsspeicher für dieses Array wird von der Anwendung zugewiesen, bevor AccessCheck aufgerufen wird. Die SACL-Auswertung wird nur durchgeführt, wenn eine Überwachung angefordert wird. Jedes Element dieses Elements kann einer der folgenden Werte sein.

Wert	Bedeutung
AUTHZ_GENERATE_SUCCESS_AUDIT 0x1	Eine Überwachungsmeldung, die angibt, dass der Erfolg generiert wurde.
AUTHZ_GENERATE_FAILURE_AUDIT 0x2	Eine Überwachungsmeldung, die angibt, dass ein Fehler generiert wurde.

Error

Ein Array von Ergebnissen für jedes Element des Arrays. Arbeitsspeicher für dieses Array wird von der Anwendung zugewiesen, bevor AccessCheck aufgerufen wird.

In der folgenden Tabelle sind die möglichen Fehlerwerte aufgeführt.

Wert	Bedeutung
ERROR_SUCCESS	Alle Zugriffsbits, einschließlich MAXIMUM_ALLOWED, werden gewährt, und der GrantedAccessMask-Member ist nicht 0.
ERROR_PRIVILEGE_NOT_HELD	DesiredAccess umfasst ACCESS_SYSTEM_SECURITY und der Client verfügt nicht über SeSecurityPrivilege.
ERROR_ACCESS_DENIED	Enthält jede der folgenden Elemente: Die angeforderten Bits werden nicht gewährt. MaximumAllowed Bit ist aktiviert, und der gewährte Zugriff ist 0. DesiredAccess ist 0.

Anforderungen

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

Weitere Informationen

AccessCheck

Share via