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


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

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

Синтаксис

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