Compartilhar via


Função EvtGetQueryInfo (winevt.h)

Obtém informações sobre uma consulta que você executou que identifica a lista de canais ou arquivos de log que a consulta tentou acessar. A função também obtém uma lista de códigos de retorno que indica o êxito ou a falha de cada acesso.

Sintaxe

BOOL EvtGetQueryInfo(
  [in]  EVT_HANDLE            QueryOrSubscription,
  [in]  EVT_QUERY_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

Parâmetros

[in] QueryOrSubscription

Um identificador para a consulta que a funçãoEvtQuery ou EvtSubscribe retorna.

[in] PropertyId

O identificador das informações de consulta a serem recuperadas. Para obter uma lista de identificadores, consulte a enumeração EVT_QUERY_PROPERTY_ID .

[in] PropertyValueBufferSize

O tamanho do buffer PropertyValueBuffer , em bytes.

[in] PropertyValueBuffer

Um buffer alocado pelo chamador que receberá as informações de consulta. 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ê só precisará chamar essa função se passar o sinalizador EvtQueryTolerateQueryErrors para EvtQuery ou o sinalizador EvtSubscribeTolerateQueryErrors para EvtSubscribe.

Exemplos

Para obter um exemplo que mostra como usar essa função, consulte Consultando eventos.

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

EvtQuery

EvtSubscribe