Partager via


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

Voir aussi

AUTHZ_SOURCE_SCHEMA_REGISTRATION

AuthzUninstallSecurityEventSource