AddFontMemResourceEx 函式 (wingdi.h)
AddFontMemResourceEx 函式會將字型資源從記憶體映像新增至系統。
語法
HANDLE AddFontMemResourceEx(
[in] PVOID pFileView,
[in] DWORD cjSize,
[in] PVOID pvResrved,
[in] DWORD *pNumFonts
);
參數
[in] pFileView
字型資源的指標。
[in] cjSize
pbFont 所指向字型資源中的位元元組數目。
[in] pvResrved
保留的。 必須是 0。
[in] pNumFonts
指定已安裝字型數目之變數的指標。
傳回值
如果函式成功,傳回值會指定新增字型的句柄。 此句柄可唯一識別安裝在系統上的字型。 如果此函式失敗,則傳回值為零。 沒有可用的擴充錯誤資訊。
備註
此函式可讓應用程式取得內嵌在檔或網頁中的字型。 AddFontMemResourceEx 新增的字型,一律為進行呼叫且無法列舉的進程私用。
記憶體影像可以包含一個以上的字型。 當此函式成功時, pcFonts 是 DWORD 的指標,其值為此呼叫后新增至系統的字型數目。 例如,對於亞洲字型的垂直和水準臉部,這個數位可以是 2。
當函式成功時,此函式的呼叫端可以釋放 pbFont 所指向的記憶體,因為系統已建立自己的記憶體複本。 若要移除已安裝的字型,請呼叫 RemoveFontMemResourceEx。 不過,當行程消失時,即使進程未呼叫 RemoveFontMemResource,系統也會卸除字型。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | wingdi.h (包含 Windows.h) |
程式庫 | Gdi32.lib |
Dll | Gdi32.dll |