Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 de la convention d’affectation de noms universelle (UNC) du serveur distant sur lequel cette opération doit être effectuée. Si ce paramètre est 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 Eventlog clé de Registre. Notez que le journal Security est destiné uniquement à une utilisation système.
Remarque 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 de retour
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’erreur étendues, appelez GetLastError.
La fonction retourne ERROR_ACCESS_DENIED si lpSourceName spécifie le journal des événements Security.
Remarques
Si le nom de la source est introuvable, le service de journalisation des événements utilise le journal application
Pour fermer le handle dans le journal des événements, utilisez la fonction DeregisterEventSource.
Exemples
Pour obtenir un exemple, consultez Reporting an Event.
Note
L’en-tête winbase.h définit RegisterEventSource comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winbase.h (inclure Windows.h) |
| bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |