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

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

  • Статья

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

Синтаксис

PDH_FUNCTION PdhValidatePathW(
  [in] LPCWSTR szFullPathBuffer
);

Параметры

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

Требования

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

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

PdhMakeCounterPath