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 |
|---|---|
|
El identificador de consulta no es válido. |
|
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 |