共用方式為

IXpsOMPage：：GenerateUnusedLookupKey 方法 (xpsobjectmodel.h)

  • 發行項

產生可做為資源字典中資源查閱索引鍵的唯一名稱。

語法

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

參數

[in] type

產生查閱索引鍵的 IXpsOMShareable 物件類型。

[out, retval] key

這個方法所產生的查閱索引鍵字串。

傳回值

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

傳回碼 描述
S_OK
 此方法已成功。
E_POINTER
 索引鍵 為 Null。
E_INVALIDARG
 type 是指無法辨識的物件類型。

備註

若要在字典中是唯一的， 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

另請參閱

IXpsOMPage

XML Paper Specification

XPS_OBJECT_TYPE