IConnector::ConnectTo-Methode (devicetopology.h)

  • Artikel

Die ConnectTo-Methode verbindet diesen Connector mit einem Connector in einem anderen Gerätetopologieobjekt.

Syntax

HRESULT ConnectTo(
  [in] IConnector *pConnectTo
);

Parameter

[in] pConnectTo

Der andere Connector. Dieser Parameter verweist auf die IConnector-Schnittstelle des Connectorobjekts, das den Connector in der anderen Gerätetopologie darstellt. Der Aufrufer ist dafür verantwortlich, seinen gezählten Verweis auf die IConnector-Schnittstelle freizugeben, wenn er nicht mehr benötigt wird. Die ConnectTo-Methode ruft einen eigenen Verweis auf diese Schnittstelle ab.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_POINTER
 Der Zeiger pConnectTo ist NULL.
E_INVALIDARG
 Der aktuelle Connector und der Remoteconnector, auf den von pConnectTo verwiesen wird, weisen dieselbe Richtung des Datenflusses auf. Ein Connector mit Datenflussrichtung "In" muss mit einem anderen Connector mit Datenflussrichtung "Out" verbunden sein, um eine gültige Verbindung in der Topologie zu erstellen. Um den Datenfluss eines Connectors zu bestimmen, rufen Sie IConnector::GetDataFlow auf.
E_NOINTERFACE
 Das Objekt, auf das von pConnectTo verwiesen wird, ist kein gültiges Connectorobjekt.
HRESULT_FROM_WIN32(ERROR_DEVICE_ALREADY_ATTACHED)
 Einer der beiden Connectors ist bereits an einen anderen Connector angeschlossen. Informationen zu diesem Makro finden Sie in der Dokumentation zum Windows SDK.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

IConnector-Schnittstelle