Fungsi DdeQueryConvInfo (ddeml.h)
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 |
Lihat juga
Konseptual
Pustaka Manajemen Pertukaran Data Dinamis
Referensi