IConnector::ConnectTo-Methode (devicetopology.h)
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 |
|---|---|
|
Der Zeiger pConnectTo ist NULL. |
|
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. |
|
Das Objekt, auf das von pConnectTo verwiesen wird, ist kein gültiges Connectorobjekt. |
|
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 |