EvtOpenChannelEnum, fonction (winevt.h)

Obtient un handle que vous utilisez pour énumérer la liste des canaux inscrits sur l’ordinateur.

Syntaxe

EVT_HANDLE EvtOpenChannelEnum(
  [in] EVT_HANDLE Session,
  [in] DWORD      Flags
);

Paramètres

[in] Session

Handle de session à distance que la fonction EvtOpenSession retourne. Définissez sur NULL pour énumérer les canaux sur l’ordinateur local.

[in] Flags

Réservé. Doit être zéro.

Valeur retournée

Si elle réussit, la fonction retourne un handle à la liste des noms de canaux inscrits sur l’ordinateur ; sinon, NULL. Si la valeur est NULL, appelez la fonction GetLastError pour obtenir le code d’erreur.

Remarques

L’énumération inclut tous les canaux définis par les fournisseurs inscrits sur l’ordinateur. Pour énumérer les noms de canal, appelez la fonction EvtNextChannelPath dans une boucle. Les noms sont triés par ordre alphabétique.

Vous devez appeler la fonction EvtClose pour fermer le handle d’énumérateur lorsque vous avez terminé.

Exemples

Pour obtenir un exemple montrant comment utiliser cette fonction, consultez Obtention et définition des propriétés de configuration d’un canal.

Configuration requise

Condition requise	Valeur
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

EvtNextChannelPath

EvtOpenChannelConfig