WM_DDE_INITIATE pesan

Aplikasi klien Dynamic Data Exchange (DDE) mengirimkan pesan WM_DDE_INITIATE untuk memulai percakapan dengan aplikasi server yang merespons nama aplikasi dan topik yang ditentukan. Setelah menerima pesan ini, semua aplikasi server dengan nama yang cocok dengan aplikasi yang ditentukan dan yang mendukung topik yang ditentukan diharapkan untuk mengakuinya. (Untuk informasi selengkapnya, lihat pesan WM_DDE_ACK .)

#define WM_DDE_INITIATE        0x03E0

Parameter

wParam

Handel ke jendela klien yang mengirim pesan.

lParam

Kata urutan rendah berisi atom yang mengidentifikasi aplikasi yang diminta percakapan. Nama aplikasi tidak boleh berisi garis miring (/) atau garis miring terbelakang (\). Karakter ini dicadangkan untuk implementasi jaringan. Jika parameter ini NULL, percakapan dengan semua aplikasi diminta.

Kata urutan tinggi berisi atom yang mengidentifikasi topik yang diminta percakapan. Jika topiknya NULL, percakapan untuk semua topik yang tersedia akan diminta.

Keterangan

Jika kata urutan rendah dari lParam adalah NULL, aplikasi server apa pun dapat merespons. Jika kata urutan tinggi dari lParam adalah NULL, topik apa pun valid. Setelah menerima permintaan WM_DDE_INITIATE dengan kata urutan tinggi dari parameter lParam yang diatur ke NULL, server harus mengirim pesan WM_DDE_ACK untuk setiap topik yang didukungnya.

Mengirim

Klien menyiarkan pesan ke semua jendela tingkat atas dengan mengatur parameter pertama SendMessage ke HWND_BROADCAST.

Jika aplikasi klien telah mendapatkan handel jendela server yang diinginkan, aplikasi klien dapat mengirim WM_DDE_INITIATE langsung ke jendela server dengan melewati handel jendela server sebagai parameter pertama SendMessage.

Aplikasi klien mengalokasikan atom dengan memanggil fungsi GlobalAddAtom .

Ketika SendMessage kembali, aplikasi klien harus menghapus atom.

Menerima

Untuk menyelesaikan inisiasi percakapan, aplikasi server harus merespons dengan satu atau beberapa pesan WM_DDE_ACK , di mana setiap pesan adalah untuk topik terpisah. Saat mengirim pesan WM_DDE_ACK , server harus membuat atom baru; seharusnya tidak menggunakan kembali atom yang dikirim dengan WM_DDE_INITIATE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Dde.h (sertakan Windows.h)

Lihat juga

Referensi

GlobalAddAtom

PostMessage

SendMessage

WM_DDE_ACK

Konseptual

Tentang Dynamic Data Exchange