AuthzOpenObjectAudit-Funktion (authz.h)

Die AuthzOpenObjectAudit-Funktion liest die Systemzugriffssteuerungsliste (SACL ) des angegebenen Sicherheitsdeskriptors und generiert alle geeigneten Überwachungen, die von dieser SACL angegeben werden.

Syntax

AUTHZAPI BOOL AuthzOpenObjectAudit(
  [in] DWORD                       Flags,
  [in] AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
  [in] PAUTHZ_ACCESS_REQUEST       pRequest,
  [in] AUTHZ_AUDIT_EVENT_HANDLE    hAuditEvent,
  [in] PSECURITY_DESCRIPTOR        pSecurityDescriptor,
  [in] PSECURITY_DESCRIPTOR        *OptionalSecurityDescriptorArray,
  [in] DWORD                       OptionalSecurityDescriptorCount,
  [in] PAUTHZ_ACCESS_REPLY         pReply
);

Parameter

[in] Flags

Für die zukünftige Verwendung reserviert.

[in] hAuthzClientContext

Ein Handle für den Clientkontext des zu öffnenden Objekts.

[in] pRequest

Ein Zeiger auf eine AUTHZ_ACCESS_REQUEST-Struktur .

[in] hAuditEvent

Ein Handle für das zu verwendende Überwachungsereignis.

[in] pSecurityDescriptor

Ein Zeiger auf die SECURITY_DESCRIPTOR-Struktur für das -Objekt.

[in] OptionalSecurityDescriptorArray

Ein Zeiger auf ein Array von SECURITY_DESCRIPTOR Strukturen.

[in] OptionalSecurityDescriptorCount

Die Anzahl der Elemente in SecurityDescriptorArray.

[in] pReply

Ein Zeiger auf eine AUTHZ_ACCESS_REPLY-Struktur .

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ein Wert ungleich null zurückgegeben.

Wenn die Funktion fehlschlägt, wird ein Nullwert zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

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	authz.h
Bibliothek	Authz.lib
DLL	Authz.dll
Verteilbare Komponente	Windows Server 2003 Administration Tools Pack unter Windows XP

Weitere Informationen

Grundlegende Access Control-Funktionen