Fungsi DdeConnect (ddeml.h)
Membuat percakapan dengan aplikasi server yang mendukung nama layanan dan pasangan nama topik yang ditentukan. Jika ada lebih dari satu server tersebut, sistem hanya memilih satu server.
Sintaks
HCONV DdeConnect(
[in] DWORD idInst,
[in] HSZ hszService,
[in] HSZ hszTopic,
[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. Handel ini harus dibuat oleh panggilan sebelumnya ke fungsi DdeCreateStringHandle . Jika parameter ini adalah 0L, percakapan dibuat dengan server yang tersedia.
[in] hszTopic
Jenis: HSZ
Handel ke string yang menentukan nama topik tempat percakapan akan dibuat. Handel ini harus dibuat oleh panggilan sebelumnya ke DdeCreateStringHandle. Jika parameter ini adalah 0L, percakapan tentang topik apa pun yang didukung oleh server yang dipilih 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: HCONV
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke percakapan yang ditetapkan.
Jika fungsi gagal, nilai yang dikembalikan adalah 0L.
Fungsi DdeGetLastError dapat digunakan untuk mendapatkan kode kesalahan, yang bisa menjadi salah satu nilai berikut:
Keterangan
Aplikasi klien tidak dapat membuat asumsi mengenai server yang dipilih. Jika nama khusus instans ditentukan dalam parameter hszService , percakapan dibuat hanya dengan instans yang ditentukan. Nama layanan khusus instans diteruskan ke fungsi panggilan balik Dynamic Data Exchange (DDE) aplikasi selama transaksi XTYP_REGISTER dan XTYP_UNREGISTER .
Semua anggota struktur CONVCONTEXT default diatur ke nol kecuali cb, yang menentukan ukuran struktur, dan iCodePage, yang 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