Fungsi FreeResource (libloaderapi.h)

Catatan

Fungsi ini usang dan hanya didukung untuk kompatibilitas mundur dengan Windows 16-bit. Untuk aplikasi Windows 32-bit, tidak perlu membebaskan sumber daya yang dimuat menggunakan LoadResource. Untuk versi modern Windows, fungsi ini selalu mengembalikan FALSE.

Penurunan (berkurang satu per satu) jumlah referensi sumber daya yang dimuat. Ketika jumlah referensi mencapai nol, memori yang ditempati oleh sumber daya dibebaskan.

Sintaks

BOOL FreeResource(
  [in] HGLOBAL hResData
);

Parameter

[in] hResData

Jenis: HGLOBAL

Handel sumber daya. Diasumsikan bahwa hglbResource dibuat oleh LoadResource.

Menampilkan nilai

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan adalah nol.

Jika fungsi gagal, nilai yang dikembalikan bukan nol, yang menunjukkan bahwa sumber daya belum dibebaskan.

Keterangan

Untuk sumber daya yang dimuat dengan fungsi lain, FreeResource telah digantikan oleh fungsi berikut:

Jenis Sumber Daya	Penggantian FreeResource
Accelerator	DestroyAcceleratorTable
Bitmap	DeleteObject
Kursor	DestroyCursor
Ikon	DestroyIcon
Menu	DestroyMenu

 

Jumlah referensi untuk sumber daya bertambah (ditingkatkan satu) setiap kali aplikasi memanggil fungsi LoadResource untuk sumber daya.

Sistem secara otomatis menghapus sumber daya ini ketika proses yang membuatnya berakhir. Namun, memanggil fungsi yang sesuai akan menghemat memori. Untuk informasi selengkapnya, lihat LoadResource.

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	libloaderapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

DeleteObject

DestroyAcceleratorTable

DestroyCursor

DestroyIcon

DestroyMenu

LoadResource

Sumber Daya Lain

Referensi