Share via


IXpsOMGlyphs::GetDeviceFontName 方法 (xpsobjectmodel.h)

取得裝置字型的名稱。

語法

HRESULT GetDeviceFontName(
  [out, retval] LPWSTR *deviceFontName
);

參數

[out, retval] deviceFontName

包含裝置字型未逸出名稱的字串。 如果尚未設定名稱,則會傳回 NULL 指標。

傳回值

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

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

備註

裝置字型名稱可唯一識別特定的裝置字型,而且通常是由硬體廠商或字型廠商所定義。

串行化物件時,會建立裝置字型名稱的逸出版本。

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

另請參閱

IXpsOMGlyphs

XML Paper Specification

XPS 檔案錯誤