Функция 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. Ниже приведены возможные значения.
| Код возврата | Описание |
|---|---|
|
Параметр недопустим или неправильно отформатирован. |
|
Недопустимый дескриптор счетчика. |
Комментарии
Данные счетчика блокируются (защищаются) на время вызова 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 |