EvtNextChannelPath, fonction (winevt.h)

Article
03/06/2024

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

Code/valeur de retour	Description
TRUE	La fonction a réussi.
FALSE	La fonction a échoué. Pour obtenir le code d’erreur, appelez la fonction GetLastError .

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

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

EvtOpenChannelEnum

Partager via