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