共用方式為

IConnector：：GetConnectorIdConnectedTo 方法 (devicetopology.h)

  • 發行項

GetConnectorIdConnectedTo 方法會取得連接器的全域識別碼，如果有的話，此連接器已連線。

語法

HRESULT GetConnectorIdConnectedTo(
  [out] LPWSTR *ppwstrConnectorId
);

參數

[out] ppwstrConnectorId

字串指標的指標的指標，此方法會將包含另一個連接器之全域標識元之 Null 終止寬字元字串的位址寫入其中。 方法會配置字串的記憶體。 呼叫端會藉由呼叫 CoTaskMemFree 函式，負責釋出不再需要的記憶體。 如果 GetConnectorIdConnectedTo 呼叫失敗， *ppwstrConnectorId 為 NULL。 如需 CoTaskMemFree 的相關信息，請參閱 Windows SDK 檔。

傳回值

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

傳回碼 Description
E_NOTFOUND
 此連接器未連線，或連線的另一端不是另一個裝置拓撲 (，例如Software_IO連線) 。
E_POINTER
 參數 ppwstrConnectorId 為 NULL。
E_OUTOFMEMORY
 記憶體不足。

備註

全域標識碼是一個字串，可唯一識別系統中所有裝置拓撲中所有元件之間的部分。 客戶端應該將此字串視為不透明。 也就是說，客戶端不應該嘗試剖析字串的內容，以取得元件的相關信息。 原因是字串格式未定義，而且可能會從 DeviceTopology API 的其中一個實作變更為下一個實作。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 devicetopology.h

另請參閱

IConnector 介面