Freigeben über


AuthzInstallSecurityEventSource-Funktion (authz.h)

Die AuthzInstallSecurityEventSource-Funktion installiert die angegebene Quelle als Sicherheitsereignisquelle.

Syntax

AUTHZAPI BOOL AuthzInstallSecurityEventSource(
  [in] DWORD                             dwFlags,
  [in] PAUTHZ_SOURCE_SCHEMA_REGISTRATION pRegistration
);

Parameter

[in] dwFlags

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf 0 (null) festgelegt werden.

[in] pRegistration

Ein Zeiger auf eine AUTHZ_SOURCE_SCHEMA_REGISTRATION-Struktur , die Informationen zur hinzuzufügenden Sicherheitsereignisquelle enthält.

Die Member der AUTHZ_SOURCE_SCHEMA_REGISTRATION-Struktur werden wie folgt verwendet, um die Sicherheitsereignisquelle im Sicherheitsprotokollschlüssel zu installieren:

  • Das szEventSourceName-Element wird als Registrierungsschlüssel unter hinzugefügt.
    HKEY_LOCAL_MACHINE
       SYSTEM
          CurrentControlSet
             Services
                EventLog
                   Security
  • Das szEventMessageFile-Element wird als Daten in einem REG_SZ Wert namens EventMessageFile unter dem Ereignisquellschlüssel hinzugefügt.
  • Das szEventAccessStringsFile-Element wird als Daten in einem REG_SZ Wert namens ParameterMessageFile unter dem Ereignisquellschlüssel hinzugefügt.
  • Wenn der Registrierungspfad nicht vorhanden ist, wird er erstellt.
  • Wenn das szEventSourceXmlSchemaFile-Element nicht NULL ist, wird es als Daten in einem REG_SZ Wert namens XmlSchemaFile unter dem Ereignisquellschlüssel hinzugefügt. Dieser Wert wird nicht verwendet.
  • Das szExecutableImagePath-Element kann auf NULL festgelegt werden.

Rückgabewert

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

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

AUTHZ_SOURCE_SCHEMA_REGISTRATION

AuthzUninstallSecurityEventSource