Fungsi RegisterWindowMessageA (winuser.h)

Artikel
03/13/2024

Menentukan pesan jendela baru yang dijamin unik di seluruh sistem. Nilai pesan dapat digunakan saat mengirim atau memposting pesan.

Sintaks

UINT RegisterWindowMessageA(
  [in] LPCSTR lpString
);

Parameter

[in] lpString

Jenis: LPCTSTR

Pesan yang akan didaftarkan.

Nilai kembali

Jenis: UINT

Jika pesan berhasil didaftarkan, nilai yang dikembalikan adalah pengidentifikasi pesan dalam rentang 0xC000 melalui 0xFFFF.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi RegisterWindowMessage biasanya digunakan untuk mendaftarkan pesan untuk berkomunikasi antara dua aplikasi yang bekerja sama.

Jika dua aplikasi yang berbeda mendaftarkan string pesan yang sama, aplikasi mengembalikan nilai pesan yang sama. Pesan tetap terdaftar sampai sesi berakhir.

Hanya gunakan RegisterWindowMessage ketika lebih dari satu aplikasi harus memproses pesan yang sama. Untuk mengirim pesan privat dalam kelas jendela, aplikasi dapat menggunakan bilangan bulat apa pun dalam rentang WM_USER melalui 0x7FFF. (Pesan dalam rentang ini bersifat privat ke kelas jendela, bukan ke aplikasi. Misalnya, kelas kontrol yang telah ditentukan sebelumnya seperti BUTTON, EDIT, LISTBOX, dan COMBOBOX dapat menggunakan nilai dalam rentang ini.)

Contoh

Misalnya, lihat Menemukan Teks.

Catatan

Header winuser.h mendefinisikan RegisterWindowMessage 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-message-l1-1-0 (diperkenalkan dalam Windows 8)