IConnector：：GetConnectedTo 方法 (devicetopology.h)

GetConnectedTo方法會取得此連接器所連接的連接器。

語法

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

[out] ppConTo

指標變數的指標，方法會寫入其他連接器物件的 IConnector 介面位址。透過這個方法，呼叫端會取得介面的計數參考。呼叫端負責藉由呼叫介面的 Release 方法，在不再需要介面時釋出介面。如果 GetConnectedTo 呼叫失敗， *ppConTo 為 Null。

如果方法成功，它會傳回 S_OK。如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼	描述
E_POINTER	指標 ppConTo 為 Null。
E_NOTFOUND	此連接器未連線，或連線的另一端不是另一個裝置拓撲 (，例如Software_IO連線) 。
HRESULT_FROM_WIN32 (ERROR_PATH_NOT_FOUND)	連線另一端的裝置拓撲不在作用中 (也就是說，裝置狀態不會DEVICE_STATE_ACTIVE) 。

如需呼叫此方法的程式碼範例，請參閱裝置拓撲中的 GetHardwareDeviceTopology 和 SelectCaptureDevice 函式的實作。

如需Software_IO連線的相關資訊，請參閱 ConnectorType 列舉。如需HRESULT_FROM_WIN32宏的相關資訊，請參閱 Windows SDK 檔。如需DEVICE_STATE_NOTPRESENT裝置狀態的相關資訊，請參閱 DEVICE_STATE_XXX常數。