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


функция CM_Connect_MachineW (cfgmgr32.h)

[Начиная с Windows 8 и Windows Server 2012 функции доступа к удаленным компьютерам были удалены. Вы не можете получить доступ к удаленным компьютерам при работе в этих версиях Windows.]

Функция CM_Connect_Machine создает подключение к удаленному компьютеру.

Синтаксис

CMAPI CONFIGRET CM_Connect_MachineW(
  [in, optional] PCWSTR    UNCServerName,
  [out]          PHMACHINE phMachine
);

Параметры

[in, optional] UNCServerName

Предоставленный вызывающим элементом указатель на текстовую строку, представляющую UNC-имя системы, для которой будет установлено соединение, в том числе \ префикс. Если указатель имеет значение NULL, используется локальная система.

[out] phMachine

Адрес расположения для получения дескриптора компьютера.

Примечание Использование этой функции для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.
 

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

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.

Комментарии

Вызывающие CM_Connect_Machine должны вызывать CM_Disconnect_Machine , чтобы освободить дескриптор компьютера, после того как он больше не нужен.

Используйте дескрипторы компьютера, полученные с помощью этой функции, только с функциями диспетчера конфигурации PnP.

Функции доступа к удаленным компьютерам были удалены в Windows 8, Windows Server 2012 и более поздних операционных системах, поэтому вы не сможете получить доступ к удаленным компьютерам при работе в этих версиях Windows.

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть cfgmgr32.h (включая Cfgmgr32.h)
Библиотека Cfgmgr32.lib

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

CM_Disconnect_Machine