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 |
|---|---|
|
Der Zeiger ppConTo ist NULL. |
|
Dieser Connector ist nicht verbunden, oder die andere Seite der Verbindung ist keine andere Gerätetopologie (z. B. eine Software_IO Verbindung). |
|
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 |