EvtOpenLog, fonction (winevt.h)

Obtient un handle pour un canal ou un fichier journal que vous pouvez ensuite utiliser pour obtenir des informations sur le canal ou le fichier journal.

Syntaxe

EVT_HANDLE EvtOpenLog(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    Path,
  [in] DWORD      Flags
);

Paramètres

[in] Session

Handle de session à distance que la fonction EvtOpenSession retourne. Définissez sur NULL pour ouvrir un canal ou ouvrir un journal sur l’ordinateur local.

[in] Path

Nom du canal ou chemin d’accès complet au fichier journal exporté.

[in] Flags

Indicateur qui détermine si le paramètre Path pointe vers un fichier journal ou un canal. Pour connaître les valeurs possibles, consultez l’énumération EVT_OPEN_LOG_FLAGS .

Valeur retournée

Si elle réussit, la fonction retourne un handle au fichier ou au canal ; sinon, NULL. Si la valeur est NULL, appelez la fonction GetLastError pour obtenir le code d’erreur.

Remarques

Les chemins d’accès relatifs et les variables d’environnement ne peuvent pas être utilisés lors de la spécification d’un fichier. Un chemin d’accès UNC (Universal Naming Convention) peut être utilisé pour localiser le fichier. Toute extension de chemin d’accès relatif et de variable d’environnement doit être effectuée avant d’effectuer des appels d’API.

Pour obtenir des informations sur le canal ou le fichier journal, appelez la fonction EvtGetLogInfo .

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winevt.h
Bibliothèque	Wevtapi.lib
DLL	Wevtapi.dll

Voir aussi

EvtClearLog

EvtExportLog

EvtGetLogInfo