Freigeben über

AUTHZ_ACCESS_REPLY-Struktur (authz.h)

  • Artikel

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