Função EvtOpenLog (winevt.h)

Obtém um identificador para um canal ou arquivo de log que você pode usar para obter informações sobre o canal ou arquivo de log.

Sintaxe

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

Parâmetros

[in] Session

Um identificador de sessão remota que a função EvtOpenSession retorna. Defina como NULL para abrir um canal ou fazer logon no computador local.

[in] Path

O nome do canal ou o caminho completo para o arquivo de log exportado.

[in] Flags

Um sinalizador que determina se o parâmetro Path aponta para um arquivo de log ou canal. Para obter os valores possíveis, consulte a enumeração EVT_OPEN_LOG_FLAGS .

Valor retornado

Se tiver êxito, a função retornará um identificador para o arquivo ou canal; caso contrário, NULL. Se FOR NULL, chame a função GetLastError para obter o código de erro.

Comentários

Caminhos relativos e variáveis de ambiente não podem ser usados ao especificar um arquivo. Um caminho UNC (Convenção Universal de Nomenclatura) pode ser usado para localizar o arquivo. Qualquer expansão de caminho relativo e variável de ambiente precisa ser feita antes de fazer chamadas à API.

Para obter informações sobre o canal ou o arquivo de log, chame a função EvtGetLogInfo .

Requisitos

Confira também

EvtClearLog

EvtExportLog

EvtGetLogInfo