HeapUnlock

小甲鱼

注：本文档由 百日维新 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

HeapUnlock 函数用于释放与指定堆相关联的临界区对象的所有权或锁。它与 HeapLock 函数的功能相反。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL WINAPI HeapUnlock(
  _In_ HANDLE hHeap
);

参数解析：

参数	含义
hHeap	1. 指向将要被解锁的堆的句柄 2. 该句柄由 HeapCreate 函数或 GetProcessHeap 函数返回获取

返回值：

1. 如果函数调用成功，返回值是非 0；

2. 如果函数调用失败，返回值是 0。

若想获得更多的错误信息，可调用 GetLastError 函数。


备注：

1. HeapLock 函数主要用于防止当调用线程使用 HeapWalk 函数时，其他线程分配和释放堆内存。HeapUnlock 函数和 HeapLock 函数功能相反。

2. 每成功调用一次 HeapLock 函数，必须也调用一次 HeapUnlock 函数来与之对应。调用 HeapUnlock 函数失败将阻止尝试访问堆的调用进程的其他任何线程执行。

3. 如果 HeapUnlock 函数调用在 HEAP_NO_SERIALIZATION 属性堆上，操作结果未定义。


需求：

Minimum supported client	Windows xp [桌面应用程序 | Windows Store 程序]
Minimum supported server	Windows 2003 服务器版 [桌面应用程序 | Windows Store 程序]
Minimum supported phone	Windows Phone 8
Header	HeapApi.h (包含于 Windows.h); WinBase.h 在 Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP 上(包含于 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。