EvtNextChannelPath, fonction (winevt.h)

Obtient un nom de canal à partir de l’énumérateur.

Syntaxe

BOOL EvtNextChannelPath(
  [in]  EVT_HANDLE ChannelEnum,
  [in]  DWORD      ChannelPathBufferSize,
  [in]  LPWSTR     ChannelPathBuffer,
  [out] PDWORD     ChannelPathBufferUsed
);

Paramètres

[in] ChannelEnum

Handle de l’énumérateur que la fonction EvtOpenChannelEnum retourne.

[in] ChannelPathBufferSize

Taille de la mémoire tampon ChannelPathBuffer , en caractères.

[in] ChannelPathBuffer

Mémoire tampon allouée à l’appelant qui recevra le nom du canal. Vous pouvez définir ce paramètre sur NULL pour déterminer la taille de mémoire tampon requise.

[out] ChannelPathBufferUsed

Taille, en caractères, de la mémoire tampon allouée à l’appelant utilisée par la fonction ou de la taille de mémoire tampon requise si la fonction échoue avec ERROR_INSUFFICIENT_BUFFER.

Valeur retournée

Remarques

Appelez cette fonction dans une boucle jusqu’à ce que la fonction retourne FALSE et que le code d’erreur soit ERROR_NO_MORE_ITEMS.

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

Voir aussi

EvtOpenChannelEnum