IDirectManipulationViewport::GetTag メソッド (directmanipulation.h)

ビューポートのタグ値を取得します。

構文

HRESULT GetTag(
  [in]            REFIID riid,
  [out, optional] void   **object,
  [out, optional] UINT32 *id
);

[in] riid

インターフェイスへの IID。

[out, optional] object

タグのオブジェクト部分。

[out, optional] id

タグの識別子部分。

メソッドが成功すると、 S_OKが返されます。そうでない場合は、HRESULT エラーコードを返します。

タグは、整数 ID とコンポーネントオブジェクトモデル (COM) オブジェクトのペアリングです。これは、ビューポートを識別するためにアプリで使用できます。

out パラメーターは省略可能であるため、メソッドは ID、ビューポートオブジェクト、またはその両方を返すことができます。

次の例では、このメソッドの使用方法を示します。

IUnknown* pUnk;
UINT32 id;

HRESULT hr = pRegion->GetTag(IID_PPV_ARGS(&pUnk), &id);