Fungsi DdeAddData (ddeml.h)

Artikel
02/26/2024

Menambahkan data ke objek Dynamic Data Exchange (DDE) yang ditentukan. Aplikasi dapat menambahkan data mulai dari offset apa pun dari awal objek. Jika data baru sudah tumpang tindih dengan data yang sudah ada di objek, data baru akan menimpa data lama dalam byte tempat tumpang tindih terjadi. Isi lokasi dalam objek yang belum ditulis tidak terdefinisi.

Sintaks

HDDEDATA DdeAddData(
  [in] HDDEDATA hData,
  [in] LPBYTE   pSrc,
  [in] DWORD    cb,
  [in] DWORD    cbOff
);

Parameter

[in] hData

Jenis: HDDEDATA

Handel ke objek DDE yang menerima data tambahan.

[in] pSrc

Jenis: LPBYTE

Data yang akan ditambahkan ke objek DDE.

[in] cb

Jenis: DWORD

Panjang, dalam byte, data yang akan ditambahkan ke objek DDE, termasuk NULL yang mengakhiri, jika data adalah string.

[in] cbOff

Jenis: DWORD

Offset, dalam byte, dari awal objek DDE. Data tambahan disalin ke objek yang dimulai pada offset ini.

Mengembalikan nilai

Jenis: HDDEDATA

Jika fungsi berhasil, nilai yang dikembalikan adalah handel baru ke objek DDE. Handel baru digunakan di semua referensi ke objek .

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

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

Keterangan

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

Jika jumlah memori yang awalnya dialokasikan kurang dari yang diperlukan untuk menyimpan data yang ditambahkan, DdeAddData mengalokasikan ulang objek memori global dengan ukuran yang sesuai.

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