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

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

  • Статья

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

Синтаксис

PDH_FUNCTION PdhConnectMachineA(
  [in] LPCSTR szMachineName
);

Параметры

[in] szMachineName

Строка, завершающаяся значением NULL, указывающая имя компьютера, к которому нужно подключиться. Если значение РАВНО NULL, PDH подключается к локальному компьютеру.

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

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

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

Код возврата Описание
PDH_CSTATUS_NO_MACHINE
 Не удается подключиться к указанному компьютеру. Может быть вызвано тем, что компьютер не включен, не поддерживает PDH, не подключен к сети или имеет разрешения, заданные в реестре, которые препятствуют удаленным подключениям или удаленному мониторингу производительности пользователем.
PDH_MEMORY_ALLOCATION_FAILURE
 Не удается выделить динамический блок памяти. Происходит при серьезном нехватке памяти в системе из-за слишком большого количества приложений, запущенных в системе, или из-за нехватки файла подкачки памяти.

Комментарии

Как правило, приложения не вызывают эту функцию, и вместо этого соединение выполняется, когда приложение добавляет счетчик в запрос.

Однако эту функцию можно использовать, если требуется включить больше, чем локальный компьютер, в список Выбор счетчиков с компьютера диалогового окна Просмотр счетчиков . Дополнительные сведения см. в разделе структура PDH_BROWSE_DLG_CONFIG .

Примечание

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

Требования

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

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

PdhEnumMachines