Função EvtGetLogInfo (winevt.h)

Obtém informações sobre um canal ou arquivo de log.

Sintaxe

BOOL EvtGetLogInfo(
  [in]  EVT_HANDLE          Log,
  [in]  EVT_LOG_PROPERTY_ID PropertyId,
  [in]  DWORD               PropertyValueBufferSize,
  [in]  PEVT_VARIANT        PropertyValueBuffer,
  [out] PDWORD              PropertyValueBufferUsed
);

Parâmetros

[in] Log

Um identificador para o canal ou arquivo de log que a função EvtOpenLog retorna.

[in] PropertyId

O identificador da propriedade a ser recuperado. Para obter uma lista de identificadores de propriedade, consulte a enumeração EVT_LOG_PROPERTY_ID .

[in] PropertyValueBufferSize

O tamanho do buffer PropertyValueBuffer , em bytes.

[in] PropertyValueBuffer

Um buffer alocado pelo chamador que receberá o valor da propriedade. O buffer contém um objeto EVT_VARIANT . Você pode definir esse parâmetro como NULL para determinar o tamanho do buffer necessário.

[out] PropertyValueBufferUsed

O tamanho, em bytes, do buffer alocado pelo chamador que a função usou ou o tamanho do buffer necessário se a função falhar com ERROR_INSUFFICIENT_BUFFER.

Retornar valor

Valor/código retornado	Descrição
TRUE	A função foi bem-sucedida.
FALSE	Falha na função. Para obter o código de erro, chame a função GetLastError .

Comentários

Você pode obter informações completas para canais operacionais e Administração ou arquivos .evtx; no entanto, para canais de Depuração e Análise ou arquivos .etl, você não pode obter informações para as propriedades EvtLogFull, EvtLogOldestRecordNumber e EvtLogNumberOfLogRecords.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winevt.h
Biblioteca	Wevtapi.lib
DLL	Wevtapi.dll

Confira também

EvtOpenLog