WM_DDE_POKE pesan
Aplikasi klien Dynamic Data Exchange (DDE) memposting pesan WM_DDE_POKE ke aplikasi server DDE. Klien menggunakan pesan ini untuk meminta server menerima item data yang tidak diminta. Server diharapkan membalas dengan pesan WM_DDE_ACK yang menunjukkan apakah server menerima item data.
Untuk memposting pesan ini, panggil fungsi PostMessage dengan parameter berikut.
#define WM_DDE_POKE 0x03E7
Parameter
-
wParam
-
Handel ke jendela klien yang memposting pesan.
-
lParam
-
Kata urutan rendah adalah handel ke objek memori global yang berisi struktur DDEPOKE dengan data dan informasi tambahan.
Kata urutan tinggi berisi atom global yang mengidentifikasi item data tempat data atau pemberitahuan dikirim.
Keterangan
Pemasangan
Aplikasi klien harus mengalokasikan memori untuk objek memori global menggunakan fungsi GlobalAlloc . Aplikasi klien harus menghapus objek jika salah satu kondisi berikut ini benar:
- Aplikasi server merespons dengan pesan WM_DDE_ACK negatif.
- Anggota fRelease adalah FALSE, tetapi aplikasi server merespons dengan WM_DDE_ACK positif atau negatif.
Aplikasi klien harus membuat atom menggunakan fungsi GlobalAddAtom .
Aplikasi klien harus membuat atau menggunakan kembali parameter WM_DDE_POKE lParam dengan memanggil fungsi PackDDElParam atau fungsi ReuseDDElParam.
Menerima
Aplikasi server harus memposting pesan WM_DDE_ACK untuk merespons secara positif atau negatif. Saat memposting WM_DDE_ACK, server dapat menggunakan kembali atom, atau dapat menghapusnya dan membuat yang baru.
Server harus membuat atau menggunakan kembali parameter WM_DDE_ACK lParam dengan memanggil fungsi PackDDElParam atau fungsi ReuseDDElParam.
Untuk membebaskan objek memori global, server harus memanggil fungsi GlobalFree . Selain itu, jika format data CF_DSPMETAFILEPICT atau CF_METAFILEPICT, server juga harus memanggil DeleteMetaFile dengan handel metafile yang disematkan. Kedua format ini memiliki tingkat tidak langsung ekstra; yaitu, aplikasi harus mengunci objek untuk mendapatkan penunjuk ke handel, lalu mengunci handel tersebut untuk mendapatkan penunjuk ke struktur METAFILEPICT , dan akhirnya memanggil DeleteMetaFile dengan handel dari anggota hMF struktur METAFILEPICT .
Untuk membebaskan objek, server harus memanggil fungsi FreeDDElParam .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|