IConnector::GetConnectedTo-Methode (devicetopology.h)

Die GetConnectedTo-Methode ruft den Connector ab, mit dem dieser Connector verbunden ist.

Syntax

HRESULT GetConnectedTo(
  [out] IConnector **ppConTo
);

Parameter

[out] ppConTo

Zeiger auf eine Zeigervariable, in die die -Methode die Adresse der IConnector-Schnittstelle des anderen Connectorobjekts schreibt. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für das Freigeben der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem die Release-Methode der Schnittstelle aufgerufen wird. Wenn beim GetConnectedTo-Aufruf ein Fehler auftritt, ist *ppConToNULL.

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 ppConTo ist NULL.
E_NOTFOUND	Dieser Connector ist nicht verbunden, oder die andere Seite der Verbindung ist keine andere Gerätetopologie (z. B. eine Software_IO Verbindung).
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)	Die Gerätetopologie auf der anderen Seite der Verbindung ist nicht aktiv (das heißt, der Gerätezustand ist nicht DEVICE_STATE_ACTIVE).

Hinweise

Codebeispiele, die diese Methode aufrufen, finden Sie in den Implementierungen der Funktionen GetHardwareDeviceTopology und SelectCaptureDevice in Gerätetopologien.

Informationen zu Software_IO Verbindungen finden Sie unter ConnectorType Enumeration. Informationen zum HRESULT_FROM_WIN32 Makros finden Sie in der Dokumentation zum Windows SDK. Informationen zum DEVICE_STATE_NOTPRESENT Gerätestatus finden Sie unter DEVICE_STATE_XXX Konstanten.

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