Fungsi RegisterWindowMessageA (winuser.h)

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

Sintaksis

UINT RegisterWindowMessageA(
  [in] LPCSTR lpString
);

Parameter

[in] lpString

Jenis: LPCTSTR

Pesan yang akan didaftarkan.

Mengembalikan nilai

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, panggil GetLastError.

Komentar

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 hingga 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 sepertiTOMBOL , EDIT, LISTBOX, dan COMBOBOX dapat menggunakan nilai dalam rentang ini.)

Contoh

Misalnya, lihat Menemukan Teks.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
set API	ext-ms-win-ntuser-message-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

Konseptual

Pesan dan Antrean Pesan

PostMessage

Referensi

SendMessage