TTDeleteEmbeddedFont 函式 (t2embapi.h)

  • 發行項

釋放內嵌字型 hFontReference 所使用的記憶體。

根據預設， TTDeleteEmbeddedFont 也會從用戶的系統中移除已安裝的字型版本。 載入可安裝的字型時，仍然必須呼叫此函式來釋放內嵌字型結構所使用的記憶體，但可以指定旗標，指出該字型應該保留在系統上。

語法

LONG TTDeleteEmbeddedFont(
  [in]  HANDLE hFontReference,
  [in]  ULONG  ulFlags,
  [out] ULONG  *pulStatus
);

參數

[in] hFontReference

處理識別字型，如 TTLoadEmbeddedFont 函式中所述。

[in] ulFlags

指定字型刪除選項的旗標。 目前，此旗標可以設定為零或下列值：

值 意義
TTDELETE_DONTREMOVEFONT
 請勿從系統移除已安裝的字型，但釋放先前由內嵌字型結構佔用的記憶體。

[out] pulStatus

目前未定義。

傳回值

如果成功， TTDeleteEmbeddedFont 會傳回值 E_NONE。

已清除內嵌字型結構所佔用的記憶體。 根據預設， hFontReference 所指示的字型也會永久移除， (從系統卸載和刪除) 。

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

備註

用戶端負責呼叫此函式，以在內嵌許可權不允許用戶系統上永久安裝字型時移除字型。

規格需求

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

另請參閱

TTLoadEmbeddedFont