Fungsi OleCreateFontIndirect (olectl.h)

  • Artikel

Membuat dan menginisialisasi objek font standar menggunakan deskripsi awal properti font dalam struktur FONTDESC . Fungsi mengembalikan penunjuk antarmuka ke objek font baru yang ditentukan oleh pemanggil dalam parameter riid. Panggilan QueryInterface adalah bagian dari panggilan ini. Pemanggil bertanggung jawab untuk memanggil Rilis melalui penunjuk antarmuka yang dikembalikan.

Sintaks

WINOLECTLAPI OleCreateFontIndirect(
  [in]  LPFONTDESC lpFontDesc,
  [in]  REFIID     riid,
  [out] LPVOID     *lplpvObj
);

Parameter

[in] lpFontDesc

Alamat struktur FONTDESC yang dialokasikan pemanggil yang berisi status awal font. Nilai ini tidak boleh NULL.

[in] riid

Referensi ke pengidentifikasi antarmuka yang menjelaskan jenis penunjuk antarmuka untuk dikembalikan dalam lplpvObj.

[out] lplpvObj

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, parameter ini berisi penunjuk antarmuka yang diminta pada objek font yang baru dibuat. Jika berhasil, pemanggil bertanggung jawab untuk memanggil Rilis melalui penunjuk antarmuka ini ketika objek baru tidak lagi diperlukan. Jika tidak berhasil, nilai diatur ke NULL.

Mengembalikan nilai

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.

Menampilkan kode Deskripsi
E_NOINTERFACE
 Pengidentifikasi antarmuka yang disediakan tidak valid.
E_UNEXPECTED
 Terjadi kesalahan tidak terduga.
E_OUTOFMEMORY
 Memori untuk operasi tidak cukup.
E_INVALIDARG
Satu atau beberapa parameter tidak valid.
E_POINTER
 Alamat dalam pFontDesc atau ppvObj tidak valid. Perhatikan bahwa jika pFontDesc diatur ke NULL, fungsi mengembalikan NO_ERROR.

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 olectl.h
Pustaka OleAut32.lib
DLL OleAut32.dll

Lihat juga

FONTDESC