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


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

Указывает источник данных в режиме реального времени.

Синтаксис

PDH_FUNCTION PdhSetDefaultRealTimeDataSource(
  [in] DWORD dwDataSourceId
);

Параметры

[in] dwDataSourceId

Источник данных о производительности. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
DATA_SOURCE_REGISTRY
Источником данных является интерфейс реестра. Это значение по умолчанию.
DATA_SOURCE_WBEM
Источником данных является поставщик WMI.

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

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

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

Код возврата Описание
PDH_INVALID_ARGUMENT
Недопустимый параметр.

Комментарии

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

Если вы хотите запрашивать данные в режиме реального времени из WMI, необходимо вызвать PdhSetDefaultRealTimeDataSource , чтобы задать источник данных по умолчанию в режиме реального времени. Эту функцию необходимо вызвать перед вызовом любой другой функции API PDH.

Требования

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

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

PdhSelectDataSource