TTGetEmbeddedFontInfo 函式 (t2embapi.h)

  • 發行項

擷取內嵌字型的相關信息，例如內嵌許可權。 TTGetEmbeddedFontInfo 會執行與 TTLoadEmbeddedFont 相同的工作，但不會為內嵌字型配置內部數據結構。

語法

LONG TTGetEmbeddedFontInfo(
  [in]  ULONG         ulFlags,
  [out] ULONG         *pulPrivStatus,
  [in]  ULONG         ulPrivs,
  [out] ULONG         *pulStatus,
        READEMBEDPROC lpfnReadFromStream,
  [in]  LPVOID        lpvReadStream,
  [in]  TTLOADINFO    *pTTLoadInfo
);

參數

[in] ulFlags

指定要求的旗標。 此旗標可以有下列零或多個值。

值 意義
TTEMBED_EMBEDEUDC
 包含與字型結構相關聯的 EUDC 字型檔案數據。
TTEMBED_RAW
 傳回包含完整字元集的非壓縮字型結構。 這是函式的預設行為。
TTEMBED_SUBSET
 傳回僅包含 pusCharCodeSet 或 pulCharCodeSet 參數所指示字元的子集字型。 這些字元碼必須表示為16位或UCS-4個字元，適用於參數。
TTEMBED_TTCOMPRESSED
 傳回壓縮的字型結構。

[out] pulPrivStatus

完成時，表示字型的內嵌許可權。 可能值的清單如下：

值 意義
EMBED_PREVIEWPRINT
 預覽和列印內嵌。
EMBED_EDITABLE
 可編輯的內嵌。
EMBED_INSTALLABLE
 可安裝的內嵌。
EMBED_NOEMBEDDING
 限制的授權內嵌。

[in] ulPrivs

旗標，指出用戶端所加加的內嵌許可權進一步限制。 如需詳細資訊 ，請參閱TTLoadEmbeddedFont 。

此旗標必須具有下列其中一個值。

值 意義
LICENSE_PREVIEWPRINT
 預覽和列印內嵌。
LICENSE_EDITABLE
 可編輯的內嵌。
LICENSE_INSTALLABLE
 可安裝的內嵌。
LICENSE_NOEMBEDDING
 限制的授權內嵌。
LICENSE_DEFAULT
 使用預設內嵌層級。

[out] pulStatus

包含狀態資訊的位欄位指標，並在完成此函式時填滿。 狀態可以是零或下列值：

值 意義
TTLOAD_FONT_SUBSETTED
 載入的字型是原始字型的子集。

lpfnReadFromStream

[callback]從文件數據流讀取字型結構的用戶端定義回呼函式指標。

[in] lpvReadStream

目前未定義。 保留給數據流指標 (字型結構) 。

[in] pTTLoadInfo

TTLOADINFO 結構的指標，其中包含從中取得內嵌字型物件的 URL。

傳回值

如果成功，則會傳回E_NONE。

*pulPrivStatus 所參考的位置會識別字型的內嵌許可權。 *pulStatus 所參考的位置會識別字型的子集是否內嵌。

否則，會傳回 Embedding-Function Error Messages 中所述的錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 t2embapi.h
程式庫 T2embed.lib
Dll T2embed.dll

另請參閱

TTGetEmbeddingType

TTGetNewFontName

TTLOADINFO

TTLoadEmbeddedFont