Freigeben über


AuthzReportSecurityEvent-Funktion (authz.h)

Die AuthzReportSecurityEvent-Funktion generiert eine Sicherheitsüberwachung für eine registrierte Sicherheitsereignisquelle.

Die Überwachung für die Objektzugriffsereigniskategorie muss aktiviert sein, damit die AuthzReportSecurityEvent-Funktion eine Sicherheitsüberwachung generieren kann. Die verfügbaren Überwachungstypen werden in der AUDIT_PARAM_TYPE-Enumeration definiert.

Syntax

AUTHZAPI BOOL AuthzReportSecurityEvent(
  [in]           DWORD                                dwFlags,
  [in, out]      AUTHZ_SECURITY_EVENT_PROVIDER_HANDLE hEventProvider,
  [in]           DWORD                                dwAuditId,
  [in, optional] PSID                                 pUserSid,
  [in]           DWORD                                dwCount,
                 ...                                  
);

Parameter

[in] dwFlags

Flags, die den Typ der generierten Überwachung angeben. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert Bedeutung
APF_AuditFailure
0x00000000
Fehlerüberwachungen werden generiert.
APF_AuditSuccess
0x00000001
Erfolgsüberwachungen werden generiert.

[in, out] hEventProvider

Ein Handle für die registrierte Sicherheitsereignisquelle, die für die Überwachung verwendet werden soll.

[in] dwAuditId

Der Bezeichner der Überwachung.

[in, optional] pUserSid

Ein Zeiger auf den Sicherheitsbezeichner (Security Identifier, SID), der als Quelle der Überwachung im Ereignisprotokoll aufgeführt wird.

[in] dwCount

Die Anzahl der AuditParamFlag-Typ-Wert-Paare, die im Abschnitt Variablenargumente nach diesem Parameter angezeigt werden.

...

Eine Liste von AuditParamFlag-Typ-Wert-Paaren, die zusätzliche Informationen zum Ereignis bereitstellen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion 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) 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

AuthzRegisterSecurityEventSource

AuthzReportSecurityEventFromParams