IPart::GetTopologyObject メソッド (devicetopology.h)

  • [アーティクル]

GetTopologyObject メソッドは、この部分を含むデバイス トポロジ オブジェクトの IDeviceTopology インターフェイスへの参照を取得します。

構文

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

パラメーター

[out] ppTopology

メソッドが device-topology オブジェクトの IDeviceTopology インターフェイスのアドレスを書き込むポインター変数へのポインター。 呼び出し元は、このメソッドからインターフェイスへのカウントされた参照を取得します。 このメソッドを使用して、呼び出し元はインターフェイスへのカウントされた参照を取得します。 呼び出し元は、インターフェイスの Release メソッドを呼び出すことによって、不要になったインターフェイスを解放する必要があります。 GetTopologyObject 呼び出しが失敗した場合、*ppTopology は NULL です。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_POINTER
 ポインター ppTopology は NULL です。

解説

このメソッドを使用するコード例については、次のトピックを参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー devicetopology.h

関連項目

IDeviceTopology インターフェイス

IPart インターフェイス