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

标记的 ID 部分。

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

GetTag 和 SetTag 可用于将外部 COM 对象与内容相关联，而无需在两者之间进行外部映射。它们还可用于将信息传递给为内容生成的回调。

GetTag 查询指定接口的标记值，并返回指向该接口的指针。

标记是整数 ID (id) 与组件对象模型 (COM) 对象 (对象) 配对。应用可以使用它来识别动作。参数是可选的，因此该方法可以返回标记的两个部分、标识符部分或标记对象。

以下示例演示此方法的语法。

IUnknown* pObject;
UINT32 id;

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