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

Статья
11/20/2024

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

Синтаксис

PDH_FUNCTION PdhValidatePathExW(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCWSTR  szFullPathBuffer
);

Параметры

[in, optional] hDataSource

Обработка источника данных. Функции pdhOpenLog и pdhBindInputDataSource возвращают этот дескриптор.

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

[in] szFullPathBuffer

строке null-terminated, указывающей путь счетчика для проверки. Максимальная длина пути счетчика составляет 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 [только классические приложения]
целевая платформа	Виндоус
заголовка	pdh.h
библиотеки	Pdh.lib
DLL	Pdh.dll

См. также

PdhMakeCounterPath

PdhValidatePath

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