Fungsi DdeConnectList (ddeml.h)
Membuat percakapan dengan semua aplikasi server yang mendukung nama layanan dan pasangan nama topik yang ditentukan. Aplikasi juga dapat menggunakan fungsi ini untuk mendapatkan daftar handel percakapan dengan meneruskan fungsi handel percakapan yang ada. Pustaka Manajemen Pertukaran Data Dinamis menghapus handel percakapan yang dihentikan dari daftar percakapan. Daftar percakapan yang dihasilkan berisi handel dari semua percakapan yang saat ini dibuat yang mendukung nama layanan dan nama topik yang ditentukan.
Sintaks
HCONVLIST DdeConnectList(
[in] DWORD idInst,
[in] HSZ hszService,
[in] HSZ hszTopic,
[in] HCONVLIST hConvList,
[in, optional] PCONVCONTEXT pCC
);
Parameter
[in] idInst
Jenis: DWORD
Pengidentifikasi instans aplikasi yang diperoleh oleh panggilan sebelumnya ke fungsi DdeInitialize .
[in] hszService
Jenis: HSZ
Handel ke string yang menentukan nama layanan aplikasi server tempat percakapan akan dibuat. Jika parameter ini adalah 0L, sistem mencoba untuk membuat percakapan dengan semua server yang tersedia yang mendukung nama topik yang ditentukan.
[in] hszTopic
Jenis: HSZ
Handel ke string yang menentukan nama topik tempat percakapan akan dibuat. Handel ini harus dibuat oleh panggilan sebelumnya ke fungsi DdeCreateStringHandle . Jika parameter ini adalah 0L, sistem akan mencoba membuat percakapan pada semua topik yang didukung oleh server (atau server) yang dipilih.
[in] hConvList
Jenis: HCONVLIST
Handel ke daftar percakapan yang akan dijumlahkan. Parameter ini harus 0L jika daftar percakapan baru akan dibuat.
[in, optional] pCC
Jenis: PCONVCONTEXT
Penunjuk ke struktur CONVCONTEXT yang berisi informasi konteks percakapan. Jika parameter ini NULL, server menerima struktur CONVCONTEXT default selama transaksi XTYP_CONNECT atau XTYP_WILDCONNECT .
Nilai kembali
Jenis: HCONVLIST
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke daftar percakapan baru.
Jika fungsi gagal, nilai yang dikembalikan adalah 0L. Handel ke daftar percakapan lama tidak lagi valid.
Fungsi DdeGetLastError dapat digunakan untuk mendapatkan kode kesalahan, yang bisa menjadi salah satu nilai berikut:
Keterangan
Aplikasi harus membebaskan handel daftar percakapan yang dikembalikan oleh fungsi DdeConnectList , terlepas dari apakah ada pegangan percakapan dalam daftar yang aktif. Untuk membebaskan handel, aplikasi dapat memanggil DdeDisconnectList.
Semua anggota struktur CONVCONTEXT default diatur ke nol kecuali cb, menentukan ukuran struktur, dan iCodePage, menentukan CP_WINANSI (halaman kode default) atau CP_WINUNICODE, tergantung pada apakah versi ANSI atau Unicode dari fungsi DdeInitialize dipanggil oleh aplikasi klien.
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