AuthzInitializeObjectAccessAuditEvent-Funktion (authz.h)

  • Artikel

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