Bagikan melalui


Fungsi RegisterWindowMessageA (winuser.h)

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)

Lihat juga

Konseptual

Pesan dan Antrean Pesan

PostMessage

Referensi

SendMessage