Condividi tramite


Funzione EvtOpenLog (winevt.h)

Ottiene un handle per un canale o un file di log che è quindi possibile usare per ottenere informazioni sul canale o sul file di log.

Sintassi

EVT_HANDLE EvtOpenLog(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    Path,
  [in] DWORD      Flags
);

Parametri

[in] Session

Handle di sessione remoto restituito dalla funzione EvtOpenSession . Impostare su NULL per aprire un canale o accedere al computer locale.

[in] Path

Nome del canale o del percorso completo del file di log esportato.

[in] Flags

Flag che determina se il parametro Path punta a un file di log o a un canale. Per i valori possibili, vedere l'enumerazione EVT_OPEN_LOG_FLAGS .

Valore restituito

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

Commenti

I percorsi relativi e le variabili di ambiente non possono essere usati quando si specifica un file. È possibile usare un percorso UNC (Universal Naming Convention) per individuare il file. Qualsiasi espansione relativa di percorsi e variabili di ambiente deve essere eseguita prima di effettuare chiamate API.

Per ottenere informazioni sul canale o sul file di log, chiamare la funzione EvtGetLogInfo .

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winevt.h
Libreria Wevtapi.lib
DLL Wevtapi.dll

Vedi anche

EvtClearLog

EvtExportLog

EvtGetLogInfo