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 |