IXpsOMDictionary：：GetByKey 方法 (xpsobjectmodel.h)

获取包含指定键的条目的 IXpsOMShareable 接口指针。

语法

HRESULT GetByKey(
  [in]          LPCWSTR         key,
  [in]          IXpsOMShareable *beforeEntry,
  [out, retval] IXpsOMShareable **entry
);

参数

[in] key

在字典中找到条目的键。

[in] beforeEntry

指向字典中要搜索键的最后一个条目的 IXpsOMShareable 接口指针。 如果 beforeEntry 为 NULL 或是指向字典中不在条目的接口指针，则将搜索整个字典。

[out, retval] entry

指向其键与键匹配的字典 条目的接口指针。

返回值

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

注解

存储在字典中的接口指针通常指向派生自 IXpsOMShareable 接口的接口，如 IXpsOMBrush 和 IXpsOMVisual。 若要确定接口类型，请调用 IXpsOMShareable：：GetType 方法。

要求

另请参阅

IXpsOMDictionary

IXpsOMShareable

XML 纸张规范