Partager via


OpenEventLogA, fonction (winbase.h)

Ouvre un handle dans le journal des événements spécifié.

Syntaxe

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

Paramètres

[in] lpUNCServerName

Nom UNC (Universal Naming Convention) du serveur distant sur lequel le journal des événements doit être ouvert. Si ce paramètre est null, l’ordinateur local est utilisé.

[in] lpSourceName

Nom du journal.

Si vous spécifiez un journal personnalisé et qu’il est introuvable, le service de journalisation des événements ouvre le journal application  ; toutefois, aucun fichier de chaîne de message ou de catégorie n’est associé.

Valeur de retour

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

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

Remarques

Pour fermer le handle dans le journal des événements, utilisez la fonction CloseEventLog.

Exemples

Pour obtenir un exemple, consultez interrogation des informations sur les événements.

Note

L’en-tête winbase.h définit OpenEventLog 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
ensemble d’API ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

ClearEventLog

closeEventLog

fonctions de journalisation des événements

de clé Eventlog

ReadEventLog

reportEvent