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

Статья
11/20/2024

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

Синтаксис

PDH_FUNCTION PdhConnectMachineA(
  [in] LPCSTR szMachineName
);

Параметры

[in] szMachineName

строке null-terminated, указывающей имя компьютера для подключения. Если значение NULL, PDH подключается к локальному компьютеру.

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

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

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

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

Возвращаемый код

Описание

PDH_CSTATUS_NO_MACHINE

Не удается подключиться к указанному компьютеру. Может быть вызвано тем, что компьютер не включен, не поддерживает PDH, не подключен к сети или имеет разрешения, заданные в реестре, которые препятствуют удаленным подключениям или удаленному мониторингу производительности пользователем.

PDH_MEMORY_ALLOCATION_FAILURE

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

Замечания

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

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

Заметка

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

Требования

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

См. также

PdhEnumMachines

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