Метод IConnector::ConnectTo (devicetopology.h)

Статья
08/23/2023

Метод ConnectTo подключает этот соединитель к соединителю в другом объекте топологии устройства.

Синтаксис

HRESULT ConnectTo(
  [in] IConnector *pConnectTo
);

Параметры

[in] pConnectTo

Другой соединитель. Этот параметр указывает на интерфейс IConnector объекта соединителя, который представляет соединитель в топологии другого устройства. Вызывающий объект отвечает за освобождение своей подсчитываемой ссылки на интерфейс IConnector , когда он больше не нужен. Метод ConnectTo получает собственную ссылку на этот интерфейс.

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

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

Код возврата	Описание
E_POINTER	Указатель pConnectTo имеет значение NULL.
E_INVALIDARG	Текущий соединитель и удаленный соединитель, на который указывает pConnectTo, имеют одинаковое направление потока данных. Соединитель с направлением потока данных "Вход" должен быть подключен к другому соединителю с направлением потока данных "Out", чтобы создать допустимое соединение в топологии. Чтобы определить поток данных соединителя, вызовите IConnector::GetDataFlow.
E_NOINTERFACE	Объект, на который указывает pConnectTo, не является допустимым объектом соединителя.
HRESULT_FROM_WIN32(ERROR_DEVICE_ALREADY_ATTACHED)	Один из двух соединителей уже подключен к другому соединителю. Дополнительные сведения об этом макросе см. в документации по Windows SDK.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	devicetopology.h

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

Интерфейс IConnector

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