IDirectManipulationContent：：GetTag 方法 (directmanipulation.h)

擷取此內容上設定的標記物件。

語法

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

[in] riid

要使用的介面標識碼參考。標記物件通常會實作這個介面。

[out, optional] object

標記物件。

[out, optional] id

標記的標識碼部分。

如果方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

GetTag 和 SetTag 適用於將外部 COM 對象與內容產生關聯，而不需要兩者之間的外部對應。它們也可以用來將資訊傳遞至為內容產生的回呼。

GetTag 會查詢指定介面的標記值，並傳回該介面的指標。

卷標是一組整數 標識碼 (標識符 ，) 元件物件模型 (COM) 物件 (物件) 。應用程式可以使用它來識別動作。參數是選擇性的，因此方法可以傳回標記、標識碼部分或標記物件兩個部分。

下列範例顯示這個方法的語法。

IUnknown* pObject;
UINT32 id;

HRESULT hr = pContent->GetTag(IID_PPV_ARGS(&pObject), &id);