Fungsi DdeCreateDataHandle (ddeml.h)

Artikel
08/23/2023

Membuat objek Dynamic Data Exchange (DDE) dan mengisi objek dengan data dari buffer yang ditentukan. Aplikasi DDE menggunakan fungsi ini selama transaksi yang melibatkan meneruskan data ke aplikasi mitra.

Sintaks

HDDEDATA DdeCreateDataHandle(
  [in]           DWORD  idInst,
  [in, optional] LPBYTE pSrc,
  [in]           DWORD  cb,
  [in]           DWORD  cbOff,
  [in, optional] HSZ    hszItem,
  [in]           UINT   wFmt,
  [in]           UINT   afCmd
);

Parameter

[in] idInst

Jenis: DWORD

Pengidentifikasi instans aplikasi yang diperoleh oleh panggilan sebelumnya ke fungsi DdeInitialize .

[in, optional] pSrc

Jenis: LPBYTE

Data yang akan disalin ke objek DDE. Jika parameter ini NULL, tidak ada data yang disalin ke objek .

[in] cb

Jenis: DWORD

Jumlah memori, dalam byte, untuk menyalin dari buffer yang diacu oleh pSrc. (sertakan NULL yang mengakhiri, jika data adalah string). Jika parameter ini nol, parameter pSrc diabaikan.

[in] cbOff

Jenis: DWORD

Offset, dalam byte, dari awal buffer yang diacu oleh parameter pSrc . Data yang dimulai pada offset ini disalin dari buffer ke objek DDE.

[in, optional] hszItem

Jenis: HSZ

Handel ke string yang menentukan item data yang sesuai dengan objek DDE. Handel ini harus dibuat oleh panggilan sebelumnya ke fungsi DdeCreateStringHandle . Jika handel data akan digunakan dalam transaksi XTYP_EXECUTE , parameter ini harus 0L.

[in] wFmt

Jenis: UINT

Format clipboard standar data.

[in] afCmd

Jenis: UINT

Bendera pembuatan. Parameter ini dapat HDATA_APPOWNED, yang menentukan bahwa aplikasi server yang memanggil fungsi DdeCreateDataHandle memiliki data yang dibuat oleh fungsi ini. Bendera ini memungkinkan aplikasi untuk berbagi handel data dengan aplikasi DDEML lainnya daripada membuat handel terpisah untuk diteruskan ke setiap aplikasi. Jika bendera ini ditentukan, aplikasi pada akhirnya harus membebaskan objek memori bersama yang terkait dengan handel dengan menggunakan fungsi DdeFreeDataHandle . Jika bendera ini tidak ditentukan, handel menjadi tidak valid dalam aplikasi yang membuat handel setelah handel data dikembalikan oleh fungsi panggilan balik DDE aplikasi atau digunakan sebagai parameter dalam fungsi DDEML lain.

Menampilkan nilai

Jenis: HDDEDATA

Jika fungsi berhasil, nilai yang dikembalikan adalah handel data.

Jika fungsi gagal, nilai yang dikembalikan adalah 0L.

Fungsi DdeGetLastError dapat digunakan untuk mendapatkan kode kesalahan, yang bisa menjadi salah satu nilai berikut:

Keterangan

Lokasi yang tidak terisi di objek DDE tidak terdefinisi.

Setelah handel data digunakan sebagai parameter dalam fungsi DDEML lain atau telah dikembalikan oleh fungsi panggilan balik DDE, handel hanya dapat digunakan untuk akses baca ke objek DDE yang diidentifikasi oleh handel.

Persyaratan


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