Fonction RegisterEventSourceA (winbase.h)
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.
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 |