Compartir a través de

Función EvtGetQueryInfo (winevt.h)

  • Artículo

Obtiene información sobre una consulta que ejecutó que identifica la lista de canales o archivos de registro a los que la consulta intentó acceder. La función también obtiene una lista de códigos de retorno que indica el éxito o error de cada acceso.

Sintaxis

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

Identificador de la consulta que devuelve la funciónEvtQuery o EvtSubscribe .

[in] PropertyId

Identificador de la información de consulta que se va a recuperar. Para obtener una lista de identificadores, consulte la enumeración EVT_QUERY_PROPERTY_ID .

[in] PropertyValueBufferSize

Tamaño del búfer PropertyValueBuffer , en bytes.

[in] PropertyValueBuffer

Un búfer asignado por el autor de la llamada que recibirá la información de consulta. El búfer contiene un objeto EVT_VARIANT . Puede establecer este parámetro en NULL para determinar el tamaño de búfer necesario.

[out] PropertyValueBufferUsed

Tamaño, en bytes, del búfer asignado por el autor de la llamada que la función usó o el tamaño de búfer necesario si se produce un error en la función con ERROR_INSUFFICIENT_BUFFER.

Valor devuelto

Código o valor devuelto Descripción
TRUE
 La función se ha realizado correctamente.
FALSE
 Error en la función. Para obtener el código de error, llame a la función GetLastError .

Comentarios

Solo tiene que llamar a esta función si pasa la marca EvtQueryTolerateQueryErrors a EvtQuery o la marca EvtSubscribeTolerateQueryErrors a EvtSubscribe.

Ejemplos

Para ver un ejemplo que muestra cómo usar esta función, consulte Consulta de eventos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winevt.h
Library Wevtapi.lib
Archivo DLL Wevtapi.dll

Consulte también

EvtQuery

EvtSubscribe