Функция PdhGetRawCounterValue (pdh.h)

Возвращает текущее необработанное значение счетчика.

Синтаксис

PDH_FUNCTION PdhGetRawCounterValue(
  [in]  PDH_HCOUNTER     hCounter,
  [out] LPDWORD          lpdwType,
  [out] PPDH_RAW_COUNTER pValue
);

Параметры

[in] hCounter

Дескриптор счетчика, из которого извлекается текущее необработанное значение. Функция PdhAddCounter возвращает этот дескриптор.

[out] lpdwType

Получает тип счетчика. Список типов счетчиков см. в разделе Типы счетчиков комплекта развертывания Windows Server 2003. Этот параметр является необязательным.

[out] pValue

Структура PDH_RAW_COUNTER , получающая значение счетчика.

Возвращаемое значение

Если функция выполняется успешно, она возвращает ERROR_SUCCESS.

Если функция завершается ошибкой, возвращаемым значением является системный код ошибки или код ошибки PDH. Ниже приведены возможные значения.

Код возврата	Описание
PDH_INVALID_ARGUMENT	Параметр недопустим или неправильно отформатирован.
PDH_INVALID_HANDLE	Недопустимый дескриптор счетчика.

Комментарии

Данные счетчика блокируются (защищаются) на время вызова PdhGetRawCounterValue , чтобы предотвратить любые изменения во время обработки вызова.

Если указанный экземпляр счетчика не существует, эта функция возвращает ERROR_SUCCESS, а элемент CStatusструктуры PDH_RAW_COUNTER будет содержать PDH_CSTATUS_NO_INSTANCE.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	pdh.h
Библиотека	Pdh.lib
DLL	Pdh.dll

См. также раздел

PdhCalculateCounterFromRawValue

PdhCollectQueryData

PdhGetFormattedCounterValue