AuthzInitializeObjectAccessAuditEvent2-Funktion (authz.h)

Artikel
08/22/2023

Die AuthzInitializeObjectAccessAuditEvent2-Funktion ordnet und initialisiert ein AUTHZ_AUDIT_EVENT_HANDLE Handle für die Verwendung mit der AuthzAccessCheck-Funktion .

Syntax

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

Parameter

[in] Flags

Flags, die das Verhalten der Überwachung ändern. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
AUTHZ_NO_ALLOC_STRINGS	Verwendet 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 Zugriffsüberprüfungen gültig bleibt.
AUTHZ_NO_FAILURE_AUDIT	Deaktiviert die Generierung von Fehlerüberwachungen.
AUTHZ_NO_SUCCESS_AUDIT	Deaktiviert die Generierung von Erfolgsüberwachungen.

[in] hAuditEventType

Reserviert. Dieser Parameter sollte auf NULL festgelegt werden.

[in] szOperationType

Ein Zeiger auf eine Zeichenfolge, die den zu überwachenden Vorgang angibt.

[in] szObjectType

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

[in] szObjectName

Ein Zeiger auf eine Zeichenfolge, die den Namen des Objekts angibt, auf das zugegriffen wird.

[in] szAdditionalInfo

Zeiger auf eine durch die Resource Manager definierte Zeichenfolge, die zusätzliche Überwachungsinformationen enthält.

[in] szAdditionalInfo2

Zeiger auf eine durch die Resource Manager definierte Zeichenfolge, die zusätzliche Überwachungsinformationen enthält.

[out] phAuditEvent

Ein Zeiger auf das zurückgegebene AUTHZ_AUDIT_EVENT_HANDLE Handle.

[in] dwAdditionalParameterCount

Muss auf 0 (null) festgelegt werden.

...

Zusätzliche Parameter.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE zurückgegeben.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
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