Fungsi HeapUnlock (heapapi.h)

Artikel
02/07/2024

Melepaskan kepemilikan objek bagian penting, atau kunci, yang terkait dengan tumpukan tertentu. Ini membalikkan tindakan fungsi HeapLock .

Sintaks

BOOL HeapUnlock(
  [in] HANDLE hHeap
);

Parameter

[in] hHeap

Handel ke timbunan yang akan dibuka kuncinya. Handel ini dikembalikan oleh fungsi HeapCreate atau GetProcessHeap .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi HeapLock terutama berguna untuk mencegah alokasi dan pelepasan memori heap oleh utas lain sementara utas panggilan menggunakan fungsi HeapWalk . Fungsi HeapUnlock adalah inversi dari HeapLock.

Setiap panggilan ke HeapLock harus dicocokkan dengan panggilan yang sesuai ke fungsi HeapUnlock . Kegagalan untuk memanggil HeapUnlock akan memblokir eksekusi utas lain dari proses panggilan yang mencoba mengakses timbunan.

Jika fungsi HeapUnlock dipanggil pada heap yang dibuat dengan bendera HEAP_NO_SERIALIZATION , hasilnya tidak ditentukan.

Contoh

Menghitung Heap

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	heapapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll