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 memposting pesan.

lParam

Kata berurutan rendah adalah handel ke objek memori global yang berisi struktur DDEPOKE dengan data dan informasi tambahan.

Kata berurutan tinggi berisi atom global yang mengidentifikasi item data tempat data atau pemberitahuan dikirim.

Keterangan

Memposting

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 fReleaseadalah 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_POKElParam 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_ACKlParam 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 tambahan; artinya, 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 [khusus aplikasi desktop]
Server minimum yang didukung
Windows 2000 Server [hanya aplikasi desktop]
Header
Dde.h (termasuk Windows.h)

Lihat juga

Referensi

DDEPOKE

FreeDDElParam

GlobalAddAtom

METAFILEPICT

PackDDElParam

PostMessage

Gunakan kembaliDDElParam

SendMessage

UnpackDDElParam

WM_DDE_ACK

Konseptual

Tentang Exchange Data Dinamis