Fungsi TTGetEmbeddedFontInfo (t2embapi.h)

Artikel
03/02/2024

Mengambil informasi tentang font yang disematkan, seperti izin penyematan. TTGetEmbeddedFontInfo melakukan tugas yang sama dengan TTLoadEmbeddedFont tetapi tidak mengalokasikan struktur data internal untuk font yang disematkan.

Sintaks

LONG TTGetEmbeddedFontInfo(
  [in]  ULONG         ulFlags,
  [out] ULONG         *pulPrivStatus,
  [in]  ULONG         ulPrivs,
  [out] ULONG         *pulStatus,
        READEMBEDPROC lpfnReadFromStream,
  [in]  LPVOID        lpvReadStream,
  [in]  TTLOADINFO    *pTTLoadInfo
);

Parameter

[in] ulFlags

Bendera yang menentukan permintaan. Bendera ini dapat memiliki nol atau lebih dari nilai berikut.

Nilai	Makna
TTEMBED_EMBEDEUDC	Sertakan data file font EUDC terkait dengan struktur font.
TTEMBED_RAW	Mengembalikan struktur font yang berisi kumpulan karakter lengkap, tidak dikompresi. Ini adalah perilaku default fungsi.
TTEMBED_SUBSET	Mengembalikan font subset yang hanya berisi glyph yang ditunjukkan oleh parameter pusCharCodeSet atau pulCharCodeSet . Kode karakter ini harus ditandai sebagai karakter 16-bit atau UCS-4, yang sesuai untuk parameter .
TTEMBED_TTCOMPRESSED	Mengembalikan struktur font terkompresi.

[out] pulPrivStatus

Setelah selesai, menunjukkan hak istimewa penyematan font. Daftar nilai yang mungkin mengikuti:

Nilai	Makna
EMBED_PREVIEWPRINT	Pratinjau dan Penyematan Cetak.
EMBED_EDITABLE	Penyematan yang Dapat Diedit.
EMBED_INSTALLABLE	Penyematan yang Dapat Diinstal.
EMBED_NOEMBEDDING	Penyematan Lisensi Terbatas.

[in] ulPrivs

Bendera yang menunjukkan pembatasan hak istimewa penyematan lebih lanjut, yang diberlakukan oleh klien. Lihat TTLoadEmbeddedFont untuk informasi tambahan.

Bendera ini harus memiliki salah satu nilai berikut.

Nilai	Makna
LICENSE_PREVIEWPRINT	Pratinjau dan Penyematan Cetak.
LICENSE_EDITABLE	Penyematan yang Dapat Diedit.
LICENSE_INSTALLABLE	Penyematan yang Dapat Diinstal.
LICENSE_NOEMBEDDING	Penyematan Lisensi Terbatas.
LICENSE_DEFAULT	Gunakan tingkat penyematan default.

[out] pulStatus

Pointer ke bitfield yang berisi informasi status, dan diisi setelah menyelesaikan fungsi ini. Statusnya bisa nol atau nilai berikut:

Nilai	Makna
TTLOAD_FONT_SUBSETTED	Font yang dimuat adalah subset dari font asli.

lpfnReadFromStream

[panggilan balik] Arahkan ke fungsi panggilan balik yang ditentukan klien yang membaca struktur font dari aliran dokumen.

[in] lpvReadStream

Saat ini tidak terdefinis. Dicadangkan untuk penunjuk ke aliran (struktur font).

[in] pTTLoadInfo

Penunjuk ke struktur TTLOADINFO yang berisi URL tempat objek font yang disematkan telah diperoleh.

Nilai kembali

Jika berhasil, mengembalikan E_NONE.

Lokasi yang direferensikan oleh *pulPrivStatus mengidentifikasi hak istimewa penyematan font. Lokasi yang direferensikan oleh *pulStatus mengidentifikasi apakah subset font disematkan.

Jika tidak, mengembalikan kode kesalahan yang dijelaskan dalam Pesan Kesalahan Fungsi Penyematan.

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	t2embapi.h
Pustaka	T2embed.lib
DLL	T2embed.dll

Lihat juga

Bagikan melalui