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

Статья
11/20/2024

Возвращает индекс счетчика, соответствующий указанному имени счетчика.

Синтаксис

PDH_FUNCTION PdhLookupPerfIndexByNameA(
  [in]  LPCSTR  szMachineName,
  [in]  LPCSTR  szNameBuffer,
  [out] LPDWORD pdwIndex
);

Параметры

[in] szMachineName

строка null-terminated, указывающая имя компьютера, в котором находится указанный счетчик. Имя компьютера можно указать DNS-именем или IP-адресом. Если значение NULL, функция использует локальный компьютер.

[in] szNameBuffer

строке null-terminated, содержащей имя счетчика.

[out] pdwIndex

Индекс счетчика.

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

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

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

Возвращаемый код	Описание
PDH_INVALID_ARGUMENT	Недопустимый параметр или неправильно отформатирован.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	pdh.h
библиотеки	Pdh.lib
DLL	Pdh.dll

См. также

PdhLookupPerfNameByIndex

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