Función PdhGetRawCounterValue (pdh.h)
Devuelve el valor sin procesar actual del contador.
Sintaxis
PDH_FUNCTION PdhGetRawCounterValue(
[in] PDH_HCOUNTER hCounter,
[out] LPDWORD lpdwType,
[out] PPDH_RAW_COUNTER pValue
);
Parámetros
[in] hCounter
Identificador del contador desde el que se va a recuperar el valor sin procesar actual. La función PdhAddCounter devuelve este identificador.
[out] lpdwType
Recibe el tipo de contador. Para obtener una lista de tipos de contadores, vea la sección Tipos de contadores del Kit de implementación de Windows Server 2003. Este parámetro es opcional.
[out] pValue
Estructura PDH_RAW_COUNTER que recibe el valor del contador.
Valor devuelto
Si la función se realiza correctamente, devuelve ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto es 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 |
|---|---|
|
Un parámetro no es válido o tiene un formato incorrecto. |
|
El identificador de contador no es válido. |
Comentarios
Los datos del contador están bloqueados (protegidos) durante la llamada a PdhGetRawCounterValue para evitar cambios durante el procesamiento de la llamada.
Si la instancia de contador especificada no existe, esta función devolverá ERROR_SUCCESS y el miembro CStatus de la estructura de PDH_RAW_COUNTER contendrá PDH_CSTATUS_NO_INSTANCE.
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 |