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

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

  • Статья

Собирает текущее необработанное значение данных для всех счетчиков в указанном запросе и обновляет код состояния каждого счетчика.

Синтаксис

PDH_FUNCTION PdhCollectQueryDataWithTime(
  [in, out] PDH_HQUERY hQuery,
  [out]     LONGLONG   *pllTimeStamp
);

Параметры

[in, out] hQuery

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

[out] pllTimeStamp

Метка времени, когда было получено первое значение счетчика в запросе. Время указывается как FILETIME.

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

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

Ниже приведены возможные значения.

Код возврата Описание
PDH_INVALID_HANDLE
 Недопустимый дескриптор запроса.
PDH_NO_DATA
 В настоящее время у запроса нет счетчиков.

Комментарии

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

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

Если PdhCollectQueryDataEx вызывается для данных только из одного экземпляра счетчика, а экземпляр счетчика не существует, функция возвращает PDH_NO_DATA. Однако при запросе данных из нескольких счетчиков PdhCollectQueryDataEx может вернуть ERROR_SUCCESS даже если один из экземпляров счетчика еще не существует. Это связано с тем, что неизвестно, существует ли указанный экземпляр счетчика или он будет существовать, но еще не создан. В этом случае вызовите функцию PdhGetRawCounterValue или PdhGetFormattedCounterValue для каждого интересующего экземпляра счетчика, чтобы определить, существуют ли они.

Требования

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

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

PdhCollectQueryData

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhOpenQuery