Fungsi DdeFreeDataHandle (ddeml.h)

Artikel
08/23/2023

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