HeapReAlloc

原文链接 -> 传送门

函数功能：

HeapReAlloc 函数用于重新从堆分配内存块。您可以调整内存块的大小，改变内存块其他属性。分配的内存不可移动。


API 函数原型：

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

LPVOID WINAPI HeapReAlloc(
  _In_ HANDLE hHeap,
  _In_ DWORD  dwFlags,
  _In_ LPVOID lpMem,
  _In_ SIZE_T dwBytes
);

参数解析：

返回值：

1. 如果函数调用成功，返回值为指向重新分配的内存块指针；

2. 如果函数调用失败，不指定 HEAP_GENERATE_EXCEPTIONS，则返回 NULL。

3. 如果函数调用失败，且指定 HEAP_GENERATE_EXCEPTIONS，函数会生成下列两个异常之一。异常取决于堆溢出性质。若想获取更多信息，查阅 GetExceptionCode 宏。

如果先前没有调用 SetLastError 函数，那么当 HeapReAlloc 函数调用失败时，应用程序无法通过调用 GetLastError 函数获取更多错误信息。


备注：

1. 如果函数调用成功，至少会分配用户请求的内存大小。

2. 如果函数调用失败，原内存没有释放且原句柄和指针仍然有效。

3. HeapReAlloc 函数保留被重新分配的内存内容，即使新内存分配在不同的位置。保留进程的内存内容涉及到非常耗时的内存复制操作。

4. 使用 HeapFree 函数释放内存。

5. 当两个或者多个线程尝试同时分配或者释放相同堆的内存块。这对序列化存在小小的影响，但是它必须被使用无论何时多个线程分配或者释放相同堆的内存块。使用 HEAP_NO_SERIALIZE 参数值消除堆中互斥。如果没有序列化，两个或者多个使用相同堆的线程可能会尝试同时分配或者释放内存，可能引起堆溢出。因此，HEAP_NO_SERIALIZE 参数值在下列情况是安全的：

• 进程只有一个线程。
• 进程有多个线程，但一个堆中只有一个线程在使用。
• 进程有多个线程，但应用程序使用堆时，有互斥解决方案。

需求：