Fungsi DdeConnectList (ddeml.h)

Artikel
02/28/2024

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