Funzione EvtOpenChannelEnum (winevt.h)

Ottiene un handle usato per enumerare l'elenco di canali registrati nel computer.

Sintassi

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

Parametri

[in] Session

Handle di sessione remoto restituito dalla funzione EvtOpenSession . Impostare su NULL per enumerare i canali nel computer locale.

[in] Flags

Riservato. Deve essere zero.

Valore restituito

Se ha esito positivo, la funzione restituisce un handle all'elenco dei nomi di canale registrati nel computer; in caso contrario, NULL. Se NULL, chiamare la funzione GetLastError per ottenere il codice di errore.

Commenti

L'enumerazione include tutti i canali registrati nel computer definito dai provider. Per enumerare i nomi dei canali, chiamare la funzione EvtNextChannelPath in un ciclo. I nomi sono ordinati alfabeticamente.

È necessario chiamare la funzione EvtClose per chiudere l'handle dell'enumeratore al termine.

Esempio

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

Requisiti

Vedi anche

EvtNextChannelPath

EvtOpenChannelConfig