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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	xpsobjectmodel.h