Función PdhCollectQueryDataWithTime (pdh.h)

Recopila el valor de datos sin procesar actual para todos los contadores de la consulta especificada y actualiza el código de estado de cada contador.

Sintaxis

PDH_FUNCTION PdhCollectQueryDataWithTime(
  [in, out] PDH_HQUERY hQuery,
  [out]     LONGLONG   *pllTimeStamp
);

Parámetros

[in, out] hQuery

Identificador de la consulta para la que desea recopilar datos. La función PdhOpenQuery devuelve este identificador.

[out] pllTimeStamp

Marca de tiempo cuando se recuperó el primer valor de contador de la consulta. La hora se especifica como FILETIME.

Valor devuelto

Si la función se ejecuta correctamente, devuelve ERROR_SUCCESS. De lo contrario, la función devuelve un código de error del sistema o un código de error PDH.

A continuación se muestran los valores posibles.

Código devuelto	Descripción
PDH_INVALID_HANDLE	El identificador de consulta no es válido.
PDH_NO_DATA	La consulta no tiene actualmente ningún contador.

Comentarios

Llame a esta función cuando desee recopilar datos de contadores para los contadores de la consulta. PDH almacena los valores de contador sin procesar de la colección actual y anterior.

Si desea recuperar el valor del contador sin procesar actual, llame a la función PdhGetRawCounterValue . Si desea calcular un valor que se puede mostrar para el valor del contador, llame a PdhGetFormattedCounterValue. Si la ruta de acceso del contador contiene un carácter comodín para el nombre de instancia, llame a las funciones PdhGetRawCounterArray y PdhGetFormattedCounterArray , respectivamente.

Cuando se llama a PdhCollectQueryDataEx solo para los datos de una instancia de contador y la instancia de contador no existe, la función devuelve PDH_NO_DATA. Sin embargo, si se consultan datos de más de un contador, PdhCollectQueryDataEx puede devolver ERROR_SUCCESS incluso si aún no existe una de las instancias de contador. Esto se debe a que no se sabe si la instancia de contador especificada no existe, o si existirá, pero aún no se ha creado. En este caso, llame a la función PdhGetRawCounterValue o PdhGetFormattedCounterValue para cada una de las instancias de contador de interés para determinar si existen.

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	pdh.h
Library	Pdh.lib
Archivo DLL	Pdh.dll

Consulte también

PdhCollectQueryData

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhOpenQuery