AuthzInstallSecurityEventSource, fonction (authz.h)
La fonction AuthzInstallSecurityEventSource installe la source spécifiée en tant que source d’événement de sécurité.
Syntaxe
AUTHZAPI BOOL AuthzInstallSecurityEventSource(
[in] DWORD dwFlags,
[in] PAUTHZ_SOURCE_SCHEMA_REGISTRATION pRegistration
);
Paramètres
[in] dwFlags
Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur zéro.
[in] pRegistration
Pointeur vers une structure de AUTHZ_SOURCE_SCHEMA_REGISTRATION qui contient des informations sur la source d’événement de sécurité à ajouter.
Les membres de la structure AUTHZ_SOURCE_SCHEMA_REGISTRATION sont utilisés comme suit pour installer la source de l’événement de sécurité dans la clé de journal de sécurité :
- Le membre szEventSourceName est ajouté en tant que clé de Registre sous
HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services EventLog Security
- Le membre szEventMessageFile est ajouté en tant que données dans une valeur de REG_SZ nommée EventMessageFile sous la clé de source de l’événement.
- Le membre szEventAccessStringsFile est ajouté en tant que données dans une valeur REG_SZ nommée ParameterMessageFile sous la clé de source de l’événement.
- Si le chemin du Registre n’existe pas, il est créé.
- Si le membre szEventSourceXmlSchemaFile n’est pas NULL, il est ajouté en tant que données dans une valeur REG_SZ nommée XmlSchemaFile sous la clé source de l’événement. Cette valeur n'est pas utilisée.
- Le membre szExecutableImagePath peut être défini sur NULL.
Valeur retournée
Si la fonction réussit, la fonction retourne TRUE.
Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | authz.h |
| Bibliothèque | Authz.lib |
| DLL | Authz.dll |
| Composant redistribuable | Windows Server 2003 Administration Tools Pack sur Windows XP |