Funzione EvtNextChannelPath (winevt.h)

Ottiene un nome del canale dall'enumeratore.

Sintassi

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

Parametri

[in] ChannelEnum

Handle per l'enumeratore restituito dalla funzione EvtOpenChannelEnum .

[in] ChannelPathBufferSize

Dimensioni del buffer ChannelPathBuffer , in caratteri.

[in] ChannelPathBuffer

Buffer allocato dal chiamante che riceverà il nome del canale. È possibile impostare questo parametro su NULL per determinare le dimensioni del buffer necessarie.

[out] ChannelPathBufferUsed

Dimensioni, in caratteri, del buffer allocato del chiamante utilizzato dalla funzione o dalla dimensione del buffer necessaria se la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER.

Valore restituito

Commenti

Chiamare questa funzione in un ciclo fino a quando la funzione restituisce FALSE e il codice di errore è ERROR_NO_MORE_ITEMS.

Esempio

Per un esempio che illustra come usare questa funzione, vedere Recupero e impostazione delle proprietà di configurazione di un canale.

Requisiti

Vedi anche

EvtOpenChannelEnum