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

Статья
11/20/2024

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

Синтаксис

PDH_FUNCTION PdhValidatePathA(
  [in] LPCSTR 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 [только классические приложения]
целевая платформа	Виндоус
заголовка	pdh.h
библиотеки	Pdh.lib
DLL	Pdh.dll

См. также

PdhMakeCounterPath

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