Función PdhCollectQueryData (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 PdhCollectQueryData(
  [in, out] PDH_HQUERY hQuery
);

Parámetros

[in, out] hQuery

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

Valor devuelto

Si la función se realiza 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 contiene actualmente ningún contador. Es posible que la consulta no contenga datos porque el usuario no se está ejecutando con un token con privilegios elevados (consulte Compatibilidad con acceso de usuario limitado).

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 formato para 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 la función 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 PdhCollectQueryData 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, PdhCollectQueryData 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 PdhGetRawCounterValue o PdhGetFormattedCounterValue para cada una de las instancias de contador de interés para determinar si existen.

A continuación se muestra la sintaxis si se llama a esta función desde Visual Basic.

PdhCollectQueryData(
  ByVal QueryHandle as Long  
)
as Long

Ejemplos

Para obtener un ejemplo, vea Examinar contadores de rendimiento o Leer datos de rendimiento de un archivo de registro.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	pdh.h
Library	Pdh.lib
Archivo DLL	Pdh.dll

Consulte también

PdhGetFormattedCounterValue

PdhGetRawCounterValue