Fungsi GlobalFree (winbase.h)

Artikel
08/27/2023

Membebaskan objek memori global yang ditentukan dan membatalkan handelnya.

Catatan Fungsi global memiliki overhead yang lebih besar dan menyediakan lebih sedikit fitur daripada fungsi manajemen memori lainnya. Aplikasi baru harus menggunakan fungsi heap kecuali dokumentasi menyatakan bahwa fungsi global harus digunakan. Untuk informasi selengkapnya, lihat Fungsi Global dan Lokal.

Sintaks

HGLOBAL GlobalFree(
  [in] _Frees_ptr_opt_ HGLOBAL hMem
);

Parameter

[in] hMem

Handel ke objek memori global. Handel ini dikembalikan oleh fungsi GlobalAlloc atau GlobalReAlloc . Tidak aman untuk mengosongkan memori yang dialokasikan dengan LocalAlloc.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NULL.

Jika fungsi gagal, nilai yang dikembalikan sama dengan handel ke objek memori global. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika proses memeriksa atau memodifikasi memori setelah dibebaskan, kerusakan timbunan dapat terjadi atau pengecualian pelanggaran akses (EXCEPTION_ACCESS_VIOLATION) dapat dihasilkan.

Fungsi GlobalFree akan membebaskan objek memori terkunci. Objek memori terkunci memiliki jumlah kunci yang lebih besar dari nol. Fungsi GlobalLock mengunci objek memori global dan menaikkan jumlah kunci satu per satu. Fungsi GlobalUnlock membukanya dan mengurangi jumlah kunci satu per satu. Untuk mendapatkan jumlah kunci objek memori global, gunakan fungsi GlobalFlags .

Jika aplikasi berjalan di bawah versi debug sistem, GlobalFree akan mengeluarkan pesan yang memberi tahu Anda bahwa objek terkunci sedang dikosongkan. Jika Anda menelusuri kesalahan aplikasi, GlobalFree akan memasukkan titik henti tepat sebelum membebaskan objek terkunci. Ini memungkinkan Anda untuk memverifikasi perilaku yang dimaksudkan, lalu melanjutkan eksekusi.

Contoh

Misalnya, lihat GlobalAlloc.

Persyaratan


Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll