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

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

  • Статья

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

Синтаксис

PDH_FUNCTION PdhValidatePathA(
  [in] LPCSTR szFullPathBuffer
);

Параметры

[in] szFullPathBuffer

Строка, завершающаяся нулевым значением, которая содержит путь счетчика для проверки. Максимальная длина пути счетчика — 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 определяет PdhValidatePath в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

PdhMakeCounterPath