共用方式為


IXpsOMVisual::GetName 方法 (xpsobjectmodel.h)

取得視覺效果的 Name 屬性。

語法

HRESULT GetName(
  [out, retval] LPWSTR *name
);

參數

[out, retval] name

Name 屬性字串。 如果尚未設定 Name 屬性,則會傳回 NULL 指標。

傳回值

方法會傳回 HRESULT。 可能的值包括但不限於下列數據表中的值。 如需此表格中未列出的 XPS 檔 API 傳回值的相關信息,請參閱 XPS 檔錯誤

傳回碼 描述
S_OK
此方法已成功。
E_POINTER
nameNULL

備註

這個方法會配置 名稱中所傳回字串所使用的記憶體。 如果 name 不是 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

另請參閱

IXpsOMVisual

XML Paper Specification

XPS 檔案錯誤