Fonction RegisterEventSourceA (winbase.h)

  • Article

Récupère un handle inscrit dans le journal des événements spécifié.

Syntaxe

HANDLE RegisterEventSourceA(
  [in] LPCSTR lpUNCServerName,
  [in] LPCSTR lpSourceName
);

Paramètres

[in] lpUNCServerName

Nom unc (Universal Naming Convention) du serveur distant sur lequel cette opération doit être effectuée. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] lpSourceName

Nom de la source d’événement dont le handle doit être récupéré. Le nom de la source doit être une sous-clé d’un journal sous la clé de Registre Eventlog . Notez que le journal de sécurité est destiné uniquement au système.

Note Cette chaîne ne doit pas contenir de caractères interdits dans les attributs XML, à l’exception des séquences d’échappement XML telles que < &gl.
 

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle dans le journal des événements.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

La fonction retourne ERROR_ACCESS_DENIED si lpSourceName spécifie le journal des événements de sécurité .

Remarques

Si le nom source est introuvable, le service de journalisation des événements utilise le journal des applications . Bien que les événements soient signalés, les événements n’incluent pas de descriptions, car il n’existe aucun fichier de message et de message de catégorie pour la recherche de descriptions liées aux identificateurs d’événement.

Pour fermer le handle au journal des événements, utilisez la fonction DeregisterEventSource .

Exemples

Pour obtenir un exemple, consultez Création d’un événement.

Notes

L’en-tête winbase.h définit RegisterEventSource comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

DeregisterEventSource

Fonctions de journalisation des événements

Sources d’événement

ReportEvent