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

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

  • Статья

Проверяет наличие указанного счетчика на компьютере или в файле журнала.

Синтаксис

PDH_FUNCTION PdhValidatePathExA(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCSTR   szFullPathBuffer
);

Параметры

[in, optional] hDataSource

Дескриптор к источнику данных. Функции PdhOpenLog и PdhBindInputDataSource возвращают этот дескриптор.

Чтобы проверить наличие счетчика на локальном компьютере, укажите значение NULL (это то же самое, что и вызов PdhValidatePath).

[in] szFullPathBuffer

Строка, завершающаяся значением NULL, указывающая путь счетчика для проверки. Максимальная длина пути счетчика составляет PDH_MAX_COUNTER_PATH.

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

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

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

Код возврата Описание
PDH_CSTATUS_NO_INSTANCE
 Указанный экземпляр объекта производительности не найден.
PDH_CSTATUS_NO_COUNTER
 Указанный счетчик не найден в объекте производительности.
PDH_CSTATUS_NO_OBJECT
 Указанный объект производительности не найден на компьютере или в файле журнала.
PDH_CSTATUS_NO_MACHINE
 Не удалось найти указанный компьютер или подключиться к нему.
PDH_CSTATUS_BAD_COUNTERNAME
 Не удалось проанализировать строку пути счетчика.
PDH_MEMORY_ALLOCATION_FAILURE
 Функция не может выделить необходимый временный буфер.

Комментарии

Примечание

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

Требования

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

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

PdhMakeCounterPath

PdhValidatePath