Fungsi LocalFree (winbase.h)

Artikel
08/27/2023

Membebaskan objek memori lokal yang ditentukan dan membatalkan handelnya.

Catatan Fungsi lokal 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 lokal harus digunakan. Untuk informasi selengkapnya, lihat Fungsi Global dan Lokal.

Sintaks

HLOCAL LocalFree(
  [in] _Frees_ptr_opt_ HLOCAL hMem
);

Parameter

[in] hMem

Handel ke objek memori lokal. Handel ini dikembalikan oleh fungsi LocalAlloc atau LocalReAlloc . Tidak aman untuk membebaskan memori yang dialokasikan dengan GlobalAlloc.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NULL.

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

Keterangan

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

Jika parameter hMem adalah NULL, LocalFree mengabaikan parameter dan mengembalikan NULL.

Fungsi LocalFree akan membebaskan objek memori terkunci. Objek memori terkunci memiliki jumlah kunci yang lebih besar dari nol. Fungsi LocalLock mengunci objek memori lokal dan menaikkan jumlah kunci satu per satu. Fungsi LocalUnlock membuka kuncinya dan mengurangi jumlah kunci satu per satu. Untuk mendapatkan jumlah kunci objek memori lokal, gunakan fungsi LocalFlags .

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

Contoh

Misalnya, lihat LocalAlloc.

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