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	Dde.h (sertakan Windows.h)

Lihat juga

Referensi

DDEPOKE

FreeDDElParam

GlobalAddAtom

METAFILEPICT

PackDDElParam

PostMessage

Menggunakan kembaliDElParam

SendMessage

UnpackddElParam

WM_DDE_ACK

Konseptual

Tentang Dynamic Data Exchange