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 |
---|---|
|
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ê 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 |