Función PdhGetRawCounterValue (pdh.h)

  • Artículo

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
PDH_INVALID_ARGUMENT
 Un parámetro no es válido o tiene un formato incorrecto.
PDH_INVALID_HANDLE
 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

Consulte también

PdhCalculateCounterFromRawValue

PdhCollectQueryData

PdhGetFormattedCounterValue