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

Статья
03/01/2024

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

Синтаксис

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

Параметры

[in] szMachineName

Строка, завершающаяся значением NULL, указывающая имя компьютера, на котором находится указанный счетчик. Имя компьютера можно указать с помощью DNS-имени или IP-адреса. Если значение РАВНО NULL, функция использует локальный компьютер.

[in] szNameBuffer

Строка со значением NULL, содержащая имя счетчика.

[out] pdwIndex

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

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

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

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

Код возврата	Описание
PDH_INVALID_ARGUMENT	Параметр недопустим или неправильно отформатирован.

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

Требования

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

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

PdhLookupPerfNameByIndex

Share via