Fungsi DdeAddData (ddeml.h)
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 |
Lihat juga
Konseptual
Pustaka Manajemen Pertukaran Data Dinamis
Referensi