Fungsi GetClassInfoExA (winuser.h)

Artikel
03/04/2024

Mengambil informasi tentang kelas jendela, termasuk handel ke ikon kecil yang terkait dengan kelas jendela. Fungsi GetClassInfo tidak mengambil handel ke ikon kecil.

Sintaks

BOOL GetClassInfoExA(
  [in, optional] HINSTANCE     hInstance,
  [in]           LPCSTR        lpszClass,
  [out]          LPWNDCLASSEXA lpwcx
);

Parameter

[in, optional] hInstance

Jenis: HINSTANCE

Handel ke instans aplikasi yang membuat kelas . Untuk mengambil informasi tentang kelas yang ditentukan oleh sistem (seperti tombol atau kotak daftar), atur parameter ini ke NULL.

[in] lpszClass

Jenis: LPCTSTR

Nama kelas. Nama harus dari kelas yang telah terdaftar sebelumnya atau kelas yang terdaftar oleh panggilan sebelumnya ke fungsi RegisterClass atau RegisterClassEx . Atau, parameter ini dapat menjadi atom kelas yang dibuat oleh panggilan sebelumnya ke RegisterClass atau RegisterClassEx. Atom harus dalam kata rendah lpszClass; kata urutan tinggi harus nol.

[out] lpwcx

Jenis: LPWNDCLASSEX

Penunjuk ke struktur WNDCLASSEX yang menerima informasi tentang kelas .

Nilai kembali

Jenis: BOOL

Jika fungsi menemukan kelas yang cocok dan berhasil menyalin data, nilai yang dikembalikan bukan nol.

Jika fungsi tidak menemukan kelas yang cocok dan berhasil menyalin data, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Atom kelas dibuat menggunakan fungsi RegisterClass atau RegisterClassEx , bukan fungsi GlobalAddAtom .

Catatan

Header winuser.h mendefinisikan GetClassInfoEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-windowclass-l1-1-0 (diperkenalkan dalam Windows 8)