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 |
---|---|
|
A função foi bem-sucedida. |
|
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 |