Struktur CONVINFO (ddeml.h)

  • Artikel

Berisi informasi tentang percakapan Dynamic Data Exchange (DDE).

Sintaks

typedef struct tagCONVINFO {
  DWORD       cb;
  DWORD_PTR   hUser;
  HCONV       hConvPartner;
  HSZ         hszSvcPartner;
  HSZ         hszServiceReq;
  HSZ         hszTopic;
  HSZ         hszItem;
  UINT        wFmt;
  UINT        wType;
  UINT        wStatus;
  UINT        wConvst;
  UINT        wLastError;
  HCONVLIST   hConvList;
  CONVCONTEXT ConvCtxt;
  HWND        hwnd;
  HWND        hwndPartner;
} CONVINFO, *PCONVINFO;

Anggota

cb

Jenis: DWORD

Ukuran struktur, dalam byte.

hUser

Jenis: DWORD_PTR

Data yang ditentukan aplikasi.

hConvPartner

Jenis: HCONV

Handel ke aplikasi mitra dalam percakapan DDE. Anggota ini nol jika mitra belum mendaftarkan dirinya sendiri (menggunakan fungsi DdeInitialize ) untuk melakukan panggilan fungsi DDEML. Aplikasi tidak boleh meneruskan anggota ini ke fungsi DDEML apa pun kecuali DdeQueryConvInfo.

hszSvcPartner

Jenis: HSZ

Handel ke nama layanan aplikasi mitra.

hszServiceReq

Jenis: HSZ

Handel ke nama layanan aplikasi server yang diminta untuk koneksi.

hszTopic

Jenis: HSZ

Handel ke nama topik yang diminta.

hszItem

Jenis: HSZ

Handel ke nama item yang diminta. Anggota ini spesifik untuk transaksi.

wFmt

Jenis: UINT

Format data yang dipertukarkan. Anggota ini spesifik untuk transaksi.

wType

Jenis: UINT

Jenis transaksi saat ini. Anggota ini bersifat spesifik transaksi; bisa menjadi salah satu nilai berikut.

Nilai Makna
XTYP_ADVDATA
0x4010
 Memberi tahu klien yang menyarankan data dari server telah tiba.
XTYP_ADVREQ
0x2022
 Meminta server untuk mengirim data yang diperbarui ke klien selama perulangan saran. Transaksi ini menghasilkan ketika server memanggil DdePostAdvise.
XTYP_ADVSTART
0x1030
 Meminta server untuk memulai perulangan saran dengan klien.
XTYP_ADVSTOP
0x8040
 Memberi tahu server bahwa perulangan saran berhenti.
XTYP_CONNECT
0x1062
 Meminta server untuk membuat percakapan dengan klien.
XTYP_CONNECT_CONFIRM
0x8072
 Memberi tahu server bahwa percakapan dengan klien telah dibuat.
XTYP_DISCONNECT
0x80C2
 Memberi tahu server bahwa percakapan telah dihentikan.
XTYP_EXECUTE
0x4050
 Meminta server untuk menjalankan perintah yang dikirim oleh klien.
XTYP_MONITOR
0x80F2
 Memberi tahu aplikasi yang terdaftar sebagai APPCMD_MONITOR bahwa data DDE sedang dikirimkan.
XTYP_POKE
0x4090
 Meminta server untuk menerima data yang tidak diminta dari klien.
XTYP_REGISTER
0x80A2
 Memberi tahu aplikasi DDEML lain bahwa server telah mendaftarkan nama layanan.
XTYP_REQUEST
0x20B0
 Meminta server untuk mengirim data ke klien.
XTYP_UNREGISTER
0x80D2
 Memberi tahu aplikasi DDEML lain bahwa server telah membatalkan pendaftaran nama layanan.
XTYP_WILDCONNECT
0x20E2
 Meminta server untuk membuat beberapa percakapan dengan klien yang sama.
XTYP_XACT_COMPLETE
0x8080
 Memberi tahu klien bahwa transaksi data asinkron telah selesai.

wStatus

Jenis: UINT

Status percakapan saat ini. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai Makna
ST_ADVISE
0x0002
 Satu atau beberapa tautan sedang berlangsung.
ST_BLOCKED
0x0008
 Percakapan diblokir.
ST_BLOCKNEXT
0x0080
 Percakapan akan diblokir setelah memanggil panggilan balik berikutnya.
ST_CLIENT
0x0010
 Handel con0x0010versation yang diteruskan ke fungsi DdeQueryConvInfo adalah handel sisi klien. Jika handel nol, handel percakapan yang diteruskan ke fungsi DdeQueryConvInfo adalah handel sisi server.
ST_CONNECTED
0x0001
 Percakapan tersambung.
ST_INLIST
0x0040
 Percakapan adalah anggota daftar percakapan.
ST_ISLOCAL
0x0004
 Kedua sisi percakapan menggunakan DDEML.
ST_ISSELF
0x0100
 Kedua sisi percakapan menggunakan instans DDEML yang sama.
ST_TERMINATED
0x0020
 Percakapan telah dihentikan oleh mitra.

wConvst

Jenis: UINT

Status percakapan. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
XST_ADVACKRCVD
13
 Transaksi saran baru saja selesai.
XST_ADVDATAACKRCVD
16
 Transaksi data saran baru saja selesai.
XST_ADVDATASENT
15
 Data saran telah dikirim dan sedang menunggu pengakuan.
XST_ADVSENT
11
 Transaksi saran sedang menunggu pengakuan.
XST_CONNECTED
2
 Percakapan tidak memiliki transaksi aktif.
XST_DATARCVD
6
 Data yang diminta baru saja diterima.
XST_EXECACKRCVD
10
 Transaksi eksekusi baru saja selesai.
XST_EXECSENT
9
 Transaksi eksekusi sedang menunggu pengakuan.
XST_INCOMPLETE
1
 Transaksi terakhir gagal.
XST_INIT1
3
 Mid-initiate state 1.
XST_INIT2
4
 Mid-initiate state 2.
XST_NULL
0
 Status pra-mulai.
XST_POKEACKRCVD
8
 Transaksi poke baru saja selesai.
XST_POKESENT
7
 Transaksi poke sedang menunggu pengakuan.
XST_REQSENT
5
 Transaksi permintaan sedang menunggu pengakuan.
XST_UNADVACKRCVD
14
 Transaksi yang tidak diawasi baru saja selesai.
XST_UNADVSENT
12
 Transaksi yang tidak diawasi sedang menunggu pengakuan.

wLastError

Jenis: UINT

Nilai kesalahan yang terkait dengan transaksi terakhir.

hConvList

Jenis: HCONVLIST

Handel ke daftar percakapan jika handel ke percakapan saat ini ada dalam daftar percakapan. Anggota ini NULL jika percakapan tidak ada dalam daftar percakapan.

ConvCtxt

Jenis: CONVCONTEXT

Konteks percakapan.

hwnd

Jenis: HWND

Handel ke jendela aplikasi panggilan yang terlibat dalam percakapan.

hwndPartner

Jenis: HWND

Handel ke jendela aplikasi mitra yang terlibat dalam percakapan saat ini.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header ddeml.h (termasuk Windows.h)

Lihat juga

CONVCONTEXT

Konseptual

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

Pustaka Manajemen Pertukaran Data Dinamis

Referensi