Fungsi UnregisterClassA (winuser.h)

  • Artikel

Membatalkan pendaftaran kelas jendela, membebaskan memori yang diperlukan untuk kelas .

Sintaks

BOOL UnregisterClassA(
  [in]           LPCSTR    lpClassName,
  [in, optional] HINSTANCE hInstance
);

Parameter

[in] lpClassName

Jenis: LPCTSTR

String yang dihentikan null atau atom kelas. Jika lpClassName adalah string, lpClassName menentukan nama kelas jendela. Nama kelas ini harus telah didaftarkan oleh panggilan sebelumnya ke fungsi RegisterClass atau RegisterClassEx . Kelas sistem, seperti kontrol kotak dialog, tidak dapat dibatalkan pendaftarannya. Jika parameter ini adalah atom, itu harus merupakan atom kelas yang dibuat oleh panggilan sebelumnya ke fungsi RegisterClass atau RegisterClassEx . Atom harus dalam kata urutan rendah dari lpClassName; kata urutan tinggi harus nol.

[in, optional] hInstance

Jenis: HINSTANCE

Handel ke instans modul yang membuat kelas.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika kelas tidak dapat ditemukan atau jika jendela masih ada yang dibuat dengan kelas , nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Sebelum memanggil fungsi ini, aplikasi harus menghancurkan semua jendela yang dibuat dengan kelas yang ditentukan.

Semua kelas jendela yang didaftarkan aplikasi tidak terdaftar saat dihentikan.

Atom kelas adalah atom khusus yang hanya dikembalikan oleh RegisterClass dan RegisterClassEx.

Tidak ada kelas jendela yang didaftarkan oleh DLL yang tidak terdaftar ketika .dll dibongkar.

Catatan

Header winuser.h mendefinisikan UnregisterClass sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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)

Lihat juga

Konseptual

Referensi

RegisterClass

RegisterClassEx

Kelas Jendela