Fungsi AddFontMemResourceEx (wingdi.h)

Artikel
03/04/2024

Fungsi AddFontMemResourceEx menambahkan sumber daya font dari gambar memori ke sistem.

Sintaks

HANDLE AddFontMemResourceEx(
  [in] PVOID pFileView,
  [in] DWORD cjSize,
  [in] PVOID pvResrved,
  [in] DWORD *pNumFonts
);

Parameter

[in] pFileView

Penunjuk ke sumber daya font.

[in] cjSize

Jumlah byte dalam sumber daya font yang ditujukan oleh pbFont.

[in] pvResrved

Dicadangkan. Harus 0.

[in] pNumFonts

Penunjuk ke variabel yang menentukan jumlah font yang diinstal.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan menentukan handel ke font yang ditambahkan. Handel ini secara unik mengidentifikasi font yang diinstal pada sistem. Jika fungsi gagal, nilai yang dikembalikan adalah nol. Tidak tersedia informasi kesalahan yang diperluas.

Keterangan

Fungsi ini memungkinkan aplikasi untuk mendapatkan font yang disematkan dalam dokumen atau halaman web. Font yang ditambahkan oleh AddFontMemResourceEx selalu bersifat privat untuk proses yang melakukan panggilan dan tidak dapat dijumlahkan.

Gambar memori dapat berisi lebih dari satu font. Ketika fungsi ini berhasil, pcFonts adalah penunjuk ke DWORD yang nilainya adalah jumlah font yang ditambahkan ke sistem sebagai akibat dari panggilan ini. Misalnya, angka ini bisa 2 untuk wajah vertikal dan horizontal dari font Asia.

Ketika fungsi berhasil, pemanggil fungsi ini dapat membebaskan memori yang ditujukan oleh pbFont karena sistem telah membuat salinan memorinya sendiri. Untuk menghapus font yang diinstal, panggil RemoveFontMemResourceEx. Namun, ketika prosesnya hilang, sistem akan membongkar font meskipun prosesnya tidak memanggil RemoveFontMemResource.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll