Funzione EvtOpenChannelConfig (winevt.h)

Ottiene un handle usato per leggere o modificare la proprietà di configurazione di un canale.

Sintassi

EVT_HANDLE EvtOpenChannelConfig(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    ChannelPath,
  [in] DWORD      Flags
);

Parametri

[in] Session

Handle di sessione remoto restituito dalla funzione EvtOpenSession . Impostare su NULL per accedere a un canale nel computer locale.

[in] ChannelPath

Nome del canale da accedere.

[in] Flags

Riservato. Deve essere zero.

Valore restituito

Se ha esito positivo, la funzione restituisce un handle alla configurazione del canale; in caso contrario, NULL. Se NULL, chiamare la funzione GetLastError per ottenere il codice di errore.

Commenti

Per ottenere una proprietà di configurazione, chiamare la funzione EvtGetChannelConfigProperty .

Per modificare una proprietà di configurazione, chiamare la funzione EvtSetChannelConfigProperty . Per salvare le modifiche di configurazione, chiamare la funzione EvtSaveChannelConfig .

Per enumerare i canali registrati, chiamare la funzione EvtOpenChannelEnum .

È necessario chiamare la funzione EvtClose per chiudere l'handle 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

EvtGetChannelConfigProperty

EvtOpenChannelEnum

EvtSaveChannelConfig

EvtSetChannelConfigProperty