IXpsOMPage：：GenerateUnusedLookupKey 方法 (xpsobjectmodel.h)

生成一个唯一名称，该名称可由资源字典中的资源用作查找键。

语法

HRESULT GenerateUnusedLookupKey(
  [in]          XPS_OBJECT_TYPE type,
  [out, retval] LPWSTR          *key
);

[in] type

为其生成查找键的 IXpsOMShareable 对象的类型。

[out, retval] key

此方法生成的查找键字符串。

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

为了在字典中是唯一的， GenerateUnusedLookupKey 生成的字符串由基于对象类型的前缀字符串组成，后跟四个唯一的字母数字字符。

下表显示了每种对象类型的前缀字符串。

对象类型	此对象类型的前缀字符串
XPS_OBJECT_TYPE_CANVAS	帆布_
XPS_OBJECT_TYPE_GEOMETRY	几何_
XPS_OBJECT_TYPE_GLYPHS	符号_
XPS_OBJECT_TYPE_IMAGE_BRUSH	IBrush_
XPS_OBJECT_TYPE_LINEAR_GRADIENT_BRUSH	LGBrush_
XPS_OBJECT_TYPE_MATRIX_TRANSFORM	MTransform_
XPS_OBJECT_TYPE_PATH	路径_
XPS_OBJECT_TYPE_RADIAL_GRADIENT_BRUSH	RGBrush_
XPS_OBJECT_TYPE_SOLID_COLOR_BRUSH	SCBrush_
XPS_OBJECT_TYPE_VISUAL_BRUSH	VBrush_

注意

此方法返回在此页上下文中唯一的键字符串。不保证返回可在多个页面使用的远程字典资源中唯一的密钥。

此方法分配键中返回的字符串使用的内存。如果键不为 NULL，请使用 CoTaskMemFree 函数释放内存。


最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	xpsobjectmodel.h