Compartir a través de

Función EvtNextChannelPath (winevt.h)

  • Artículo

Obtiene un nombre de canal del enumerador.

Sintaxis

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

Parámetros

[in] ChannelEnum

Identificador del enumerador que devuelve la función EvtOpenChannelEnum .

[in] ChannelPathBufferSize

Tamaño del búfer ChannelPathBuffer , en caracteres.

[in] ChannelPathBuffer

Un búfer asignado por el autor de la llamada que recibirá el nombre del canal. Puede establecer este parámetro en NULL para determinar el tamaño de búfer necesario.

[out] ChannelPathBufferUsed

Tamaño, en caracteres, del búfer asignado por el autor de la llamada que usó la función o el tamaño de búfer necesario si se produce un error en la función con ERROR_INSUFFICIENT_BUFFER.

Valor devuelto

Código o valor devuelto Descripción
TRUE
 La función se ha realizado correctamente.
FALSE
 Error en la función. Para obtener el código de error, llame a la función GetLastError .

Comentarios

Llame a esta función en un bucle hasta que la función devuelva FALSE y el código de error se ERROR_NO_MORE_ITEMS.

Ejemplos

Para obtener un ejemplo que muestra cómo usar esta función, vea Obtener y establecer las propiedades de configuración de un canal.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winevt.h
Library Wevtapi.lib
Archivo DLL Wevtapi.dll

Consulte también

EvtOpenChannelEnum