TTDeleteEmbeddedFont 函式 (t2embapi.h)
釋放內嵌字型 hFontReference 所使用的記憶體。
根據預設, TTDeleteEmbeddedFont 也會從用戶的系統中移除已安裝的字型版本。 載入可安裝的字型時,仍然必須呼叫此函式來釋放內嵌字型結構所使用的記憶體,但可以指定旗標,指出該字型應該保留在系統上。
語法
LONG TTDeleteEmbeddedFont(
[in] HANDLE hFontReference,
[in] ULONG ulFlags,
[out] ULONG *pulStatus
);
參數
[in] hFontReference
處理識別字型,如 TTLoadEmbeddedFont 函式中所述。
[in] ulFlags
指定字型刪除選項的旗標。 目前,此旗標可以設定為零或下列值:
值 | 意義 |
---|---|
|
請勿從系統移除已安裝的字型,但釋放先前由內嵌字型結構佔用的記憶體。 |
[out] pulStatus
目前未定義。
傳回值
如果成功, TTDeleteEmbeddedFont 會傳回值 E_NONE。
已清除內嵌字型結構所佔用的記憶體。 根據預設, hFontReference 所指示的字型也會永久移除, (從系統卸載和刪除) 。
否則,傳回 Embedding-Function Error Messages 中所述的錯誤碼。
備註
用戶端負責呼叫此函式,以在內嵌許可權不允許用戶系統上永久安裝字型時移除字型。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | t2embapi.h |
程式庫 | T2embed.lib |
Dll | T2embed.dll |