HeapSize
Функция HeapSize возвращает размер блока памяти, выделенного из кучи функциями HeapAlloc или HeapReAlloc , в байтах.
DWORD HeapSize
(
HANDLE
hHeap
, //
дескориптор
кучи
DWORD
dwFlags
, // контрольные флаги размера кучи
LPCVOID
lpMem
// указатель на память, чей размер возвращается
);
Параметры
hHeap
- определяет кучу, в которой находится блок памяти. Этот дескриптор возвращается функциями
HeapCreate
или
GetProcessHeap
.
dwFlags
- определяет некоторые контролируемые аспекты доступа к блоку памяти. В настоящее время определен только один флаг; тем не менее, все остальные значения флагов зарезервированы для будущего использования. Указание этого флага переопределит соответствующее значение флага, указанного в качестве значения параметра
flOptions
при создании кучи функцией
HeapCreate
.
|
Значение |
Пояснение |
|
HEAP _ NO _ SERIALIZE |
Определяет, что взаимное исключение не будет использоваться, когда функция получает доступ к куче. Для дополнительной информации смотрите раздел "Комментарии" в описании функции HeapCreate . |
lpMem - указывает на блок памяти, чей размер функция получает. Указатель возвращается функциями HeapAlloc или HeapReAlloc .
Возвращаемые значения
В случае успеха возвращается размер выделенного блока памяти в байтах.
В случае неудачи возвращается 0
xFFFFFFFF
. Функция не вызывает
SetLastError
. Приложение не может вызвать
GetLastError
для дополнительной информации об ошибке.
См. также
GetProcessHeap , HeapAlloc , HeapCreate , HeapDestroy , HeapFree , HeapReAlloc , SetLastError .