函数功能:
HeapCreate 函数创建可由调用进程使用的私有堆对象。该函数在进程的虚拟地址空间中保留空间,并为该块的指定初始部分分配物理存储空间。
函数原型:
HANDLE HeapCreate(
[in] DWORD flOptions,
[in] SIZE_T dwInitialSize,
[in] SIZE_T dwMaximumSize
);
参数解析:
参数 | 含义 | |
---|---|---|
flOptions | 堆分配选项。此参数可以是 0 或以下值中的一个或多个。 | |
值 | 含义 | |
HEAP_CREATE_ENABLE_EXECUTE (0x00040000) | 如果硬件实施数据执行保护,那么所有从堆分配的内存块都允许代码执行。在堆中执行代码的应用程序使用这个堆标志。如果没有指定 HEAP_CREATE_ENABLE_EXECUTE 且应用程序试图从一个受保护的页面运行代码,应用程序则接收到一个异常状态码 STATUS_ACCESS_VIOLATION | |
HEAP_GENERATE_EXCEPTIONS (0x00000004) | 若指定了该值,调用HeapAlloc函数和HeapReAlloc函数失败时返回具体的错误代码,而不是返回NULL | |
HEAP_NO_SERIALIZE (0x00000001) | 若指定了该值,这样建立的堆不会进行独占性检测,访问速度可以更快 | |
dwInitialSize | 堆的初始大小。指定创建堆时分配给堆的物理内存,以字节为单位。随着堆中内存的分配,当这些内存被使用完时,堆的长度可以自动扩展。该值必须小于dwMaximumSize。如果此参数为0, 则该函数提交一页。( 要确定主机上页面的大小,请使用GetSystemInfo函数) | |
dwMaximumSize | 指定了堆能够扩展到的最大值。如果指定为0,那么堆没有最大值限制,扩展范围只受限于空闲的内存总量。 |
返回值:
如果函数返回成功,则返回值是新创建的堆的句柄。
如果函数返回失败,则返回值为NULL。要获取扩展错误信息,请调用 GetLastError。