共用方式為

IPart：：GetTopologyObject 方法 (devicetopology.h)

  • 發行項

GetTopologyObject方法會取得包含此部分之裝置拓撲物件的IDeviceTopology介面參考。

語法

HRESULT GetTopologyObject(
  [out] IDeviceTopology **ppTopology
);

參數

[out] ppTopology

指標變數的指標，方法會將裝置拓撲物件的 IDeviceTopology 介面位址寫入其中。 呼叫端會從這個方法取得介面的計數參考。 透過這個方法，呼叫端會取得介面的計數參考。 呼叫端會藉由呼叫介面的 Release 方法，負責釋放不再需要的介面。 如果 GetTopologyObject 呼叫失敗， *ppTopology 為 Null。

傳回值

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

傳回碼 描述
E_POINTER
 指標 ppTopology 為 Null。

備註

如需使用此方法的程式碼範例，請參閱下列主題：

需求

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

另請參閱

IDeviceTopology 介面

IPart 介面