Bagikan melalui


Fungsi DdeFreeDataHandle (ddeml.h)

Membebaskan objek Dynamic Data Exchange (DDE) dan menghapus handel data yang terkait dengan objek .

Sintaks

BOOL DdeFreeDataHandle(
  [in] HDDEDATA hData
);

Parameter

[in] hData

Jenis: HDDEDATA

Handel ke objek DDE yang akan dikosongkan. Handel ini harus dibuat oleh panggilan sebelumnya ke fungsi DdeCreateDataHandle atau dikembalikan oleh fungsi DdeClientTransaction .

Mengembalikan nilai

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

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

Keterangan

Aplikasi harus memanggil DdeFreeDataHandle dalam keadaan berikut:

  • Untuk membebaskan objek DDE yang dialokasikan aplikasi dengan memanggil fungsi DdeCreateDataHandle jika handel data objek tidak pernah diteruskan oleh aplikasi ke fungsi Dynamic Data Exchange Management Library (DDEML) lain
  • Untuk membebaskan objek DDE yang dialokasikan aplikasi dengan menentukan bendera HDATA_APPOWNED dalam panggilan ke DdeCreateDataHandle
  • Untuk membebaskan objek DDE yang menangani aplikasi yang diterima dari fungsi DdeClientTransaction
Sistem secara otomatis membebaskan objek yang tidak berhutang ketika handelnya dikembalikan oleh fungsi panggilan balik DDE atau digunakan sebagai parameter dalam fungsi DDEML.

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

DdeAccessData

DdeClientTransaction

DdeCreateDataHandle

Pustaka Manajemen Pertukaran Data Dinamis

Referensi