Fungsi DdeQueryConvInfo (ddeml.h)

Artikel
02/26/2024

Mengambil informasi tentang transaksi Dynamic Data Exchange (DDE) dan tentang percakapan tempat transaksi berlangsung.

Sintaks

UINT DdeQueryConvInfo(
  [in]      HCONV     hConv,
  [in]      DWORD     idTransaction,
  [in, out] PCONVINFO pConvInfo
);

Parameter

[in] hConv

Jenis: HCONV

Handel ke percakapan.

[in] idTransaction

Jenis: DWORD

Transaksi. Untuk transaksi asinkron, parameter ini harus menjadi pengidentifikasi transaksi yang dikembalikan oleh fungsi DdeClientTransaction . Untuk transaksi sinkron, parameter ini harus QID_SYNC.

[in, out] pConvInfo

Jenis: PCONVINFO

Penunjuk ke struktur CONVINFO yang menerima informasi tentang transaksi dan percakapan. Anggota cb struktur CONVINFO harus menentukan panjang buffer yang dialokasikan untuk struktur.

Mengembalikan nilai

Jenis: UINT

Jika fungsi berhasil, nilai yang dikembalikan adalah jumlah byte yang disalin ke dalam struktur CONVINFO .

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE.

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

Keterangan

Aplikasi tidak boleh membebaskan handel string yang direferensikan oleh struktur CONVINFO . Jika aplikasi harus menggunakan salah satu handel string ini, aplikasi harus memanggil fungsi DdeKeepStringHandle untuk membuat salinan handel.

Jika parameter idTransaction diatur ke QID_SYNC, anggota hUser struktur CONVINFO dikaitkan dengan percakapan dan dapat digunakan untuk menyimpan data yang terkait dengan percakapan. Jika idTransaction adalah pengidentifikasi transaksi asinkron, anggota hUser hanya dikaitkan dengan transaksi saat ini dan hanya berlaku selama durasi transaksi.

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