Поделиться через

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

  • Статья

Возвращает массив необработанных значений из указанного счетчика. Используйте эту функцию, если требуется получить необработанные значения счетчика счетчика, содержащего подстановочный знак для имени экземпляра.

Синтаксис

PDH_FUNCTION PdhGetRawCounterArrayA(
  [in]      PDH_HCOUNTER            hCounter,
  [in, out] LPDWORD                 lpdwBufferSize,
  [out]     LPDWORD                 lpdwItemCount,
  [out]     PPDH_RAW_COUNTER_ITEM_A ItemBuffer
);

Параметры

[in] hCounter

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

[in, out] lpdwBufferSize

Размер буфера ItemBuffer в байтах. Если входные данные равны нулю, функция возвращает PDH_MORE_DATA и задает для этого параметра требуемый размер буфера. Если размер буфера превышает требуемый размер, функция задает для этого параметра фактический размер использованного буфера. Если указанный размер входных данных больше нуля, но меньше требуемого размера, не следует полагаться на возвращаемый размер для перераспределения буфера.

[out] lpdwItemCount

Количество необработанных значений счетчиков в буфере ItemBuffer .

[out] ItemBuffer

Буфер, выделенный вызывающим объектом, который получает массив PDH_RAW_COUNTER_ITEM структур; Структуры содержат необработанные значения счетчиков экземпляров. Если значение lpdwBufferSize равно нулю, задайте значение NULL.

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

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

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

Код возврата Описание
PDH_MORE_DATA
 Буфер ItemBuffer недостаточно велик, чтобы содержать имя объекта. Это возвращаемое значение ожидается, если lpdwBufferSize равно нулю на входных данных. Если указанный размер входных данных больше нуля, но меньше требуемого размера, не следует полагаться на возвращаемый размер для перераспределения буфера.
PDH_INVALID_ARGUMENT
 Параметр недопустим или неправильно отформатирован. Например, в некоторых выпусках эта ошибка может возникнуть, если указанный размер входных данных больше нуля, но меньше требуемого размера.
PDH_INVALID_HANDLE
 Недопустимый дескриптор счетчика.

Комментарии

Эту функцию следует вызывать дважды: первый раз, чтобы получить требуемый размер буфера (задайте для ItemBuffer значение NULL , а для lpdwBufferSize — значение 0), а второй раз — для получения данных.

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

Примечание

Заголовок pdh.h определяет PdhGetRawCounterArray в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

PDH_RAW_COUNTER_ITEM

PdhCalculateCounterFromRawValue

PdhGetFormattedCounterArray

PdhGetFormattedCounterValue