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

CONVCONTEXT

Konseptual

DdeConnectList

DdeCreateStringHandle

DdeDisconnect

DdeDisconnectList

DdeInitialize

Pustaka Manajemen Pertukaran Data Dinamis

Referensi

XTYP_REGISTER

XTYP_UNREGISTER