Fungsi DdePostAdvise (ddeml.h)

Artikel
08/23/2023

Menyebabkan sistem mengirim transaksi XTYP_ADVREQ ke fungsi panggilan balik Dynamic Data Exchange (DDE) aplikasi panggilan (server) untuk setiap klien dengan perulangan saran aktif pada topik dan item yang ditentukan. Aplikasi server harus memanggil fungsi ini setiap kali data yang terkait dengan nama topik atau pasangan nama item berubah.

Sintaks

BOOL DdePostAdvise(
  [in] DWORD idInst,
  [in] HSZ   hszTopic,
  [in] HSZ   hszItem
);

Parameter

[in] idInst

Jenis: DWORD

Pengidentifikasi instans aplikasi yang diperoleh oleh panggilan sebelumnya ke fungsi DdeInitialize .

[in] hszTopic

Jenis: HSZ

Handel ke string yang menentukan nama topik. Untuk mengirim pemberitahuan untuk semua topik dengan perulangan saran aktif, aplikasi dapat mengatur parameter ini ke 0L.

[in] hszItem

Jenis: HSZ

Handel ke string yang menentukan nama item. Untuk mengirim pemberitahuan untuk semua item dengan perulangan saran aktif, aplikasi dapat mengatur parameter ini ke 0L.

Mengembalikan nilai

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Fungsi DdeGetLastError dapat digunakan untuk mendapatkan kode kesalahan, yang bisa menjadi salah satu nilai berikut:

Keterangan

Server yang memiliki topik atau item yang tidak dapat dienumerasi harus mengatur parameter hszTopic dan hszItem ke NULL sehingga sistem menghasilkan transaksi untuk semua perulangan saran aktif. Fungsi panggilan balik DDE server mengembalikan NULL untuk perulangan saran apa pun yang tidak boleh diperbarui.

Jika server memanggil DdePostAdvise dengan topik, item, dan kumpulan nama format yang menyertakan set yang saat ini sedang ditangani dalam panggilan balik XTYP_ADVREQ , luapan tumpukan dapat mengakibatkan.

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	ddeml.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll