AuthzInitializeObjectAccessAuditEvent-Funktion (authz.h)

Artikel
02/23/2024

Die Funktion AuthzInitializeObjectAccessAuditEvent initialisiert die Überwachung für ein Objekt.

Syntax

AUTHZAPI BOOL AuthzInitializeObjectAccessAuditEvent(
  [in]  DWORD                         Flags,
  [in]  AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  [in]  PWSTR                         szOperationType,
  [in]  PWSTR                         szObjectType,
  [in]  PWSTR                         szObjectName,
  [in]  PWSTR                         szAdditionalInfo,
  [out] PAUTHZ_AUDIT_EVENT_HANDLE     phAuditEvent,
  [in]  DWORD                         dwAdditionalParameterCount,
        ...                           
);

Parameter

[in] Flags

Ändert die Überwachung. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
AUTHZ_NO_SUCCESS_AUDIT	Deaktivieren Sie die Generierung von Erfolgsüberwachungen.
AUTHZ_NO_FAILURE_AUDIT	Deaktivieren Sie die Generierung von Fehlerüberwachungen.
AUTHZ_NO_ALLOC_STRINGS	Verwenden Sie Zeiger auf die übergebenen Zeichenfolgen, anstatt Arbeitsspeicher zuzuweisen und die Zeichenfolgen zu kopieren. Die aufrufende Anwendung muss sicherstellen, dass der übergebene Arbeitsspeicher während der Zugriffsprüfungen gültig bleibt.

[in] hAuditEventType

Reserviert. Dieser Parameter sollte auf NULL festgelegt werden.

[in] szOperationType

Zeichenfolge, die den zu überwachenden Vorgang angibt.

[in] szObjectType

Zeichenfolge, die den Typ des Objekts angibt, auf das zugegriffen wird.

[in] szObjectName

String the gibt den Namen des Objekts an, auf das zugegriffen wird.

[in] szAdditionalInfo

Die vom Resource Manager definierte Zeichenfolge für zusätzliche Überwachungsinformationen.

[out] phAuditEvent

Zeiger, der eine AUTHZ_AUDIT_EVENT_HANDLE-Struktur empfängt.

[in] dwAdditionalParameterCount

Muss auf 0 festgelegt werden.

...

Zusätzliche Parameter.

Rückgabewert

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

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

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

AuthzAccessCheck

Grundlegende Access Control-Funktionen

Freigeben über