На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

HeapSize



The HeapSize function returns the size, in bytes, of a memory block allocated from a heap by the HeapAlloc or HeapReAlloc function.

DWORD HeapSize(

HANDLE hHeap, // handle to the heap
DWORD dwFlags, // heap size control flags
LPCVOID lpMem // pointer to memory to return size for
);


Parameters

hHeap

Specifies the heap in which the memory block resides. This handle is returned by the HeapCreate or GetProcessHeap function.

dwFlags

Specifies several controllable aspects of accessing the memory block. Only one flag is currently defined; however, all other flag values are reserved for future use. Specifying this flag will override the corresponding flag specified in the flOptions parameter when the heap was created by using the HeapCreate function:

Value Meaning
HEAP_NO_SERIALIZE Specifies that mutual exclusion will not be used while the function is accessing the heap. For more information about HEAP_NO_SERIALIZE, see the Remarks for HeapCreate.


lpaam

Points to the memory block whose size the function will obtain. This is a pointer returned by the HeapAlloc or HeapReAlloc function.



Return Values

If the function succeeds, the return value is the size, in bytes, of the allocated memory block.
If the function fails, the return value is 0xFFFFFFFF. The function does not call SetLastError. An application cannot call GetLastError for extended error information.

See Also

GetProcessHeap, HeapAlloc, HeapCreate, HeapDestroy, HeapFree, HeapReAlloc, SetLastError


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

HeapSize



Функция HeapSize возвращает размер, в байтах, блока памяти распределенного из кучи HeapAlloc или функцией HeapReAlloc.

DWORD HeapSize(

РУЧКА hHeap, // оперируется в кучу DWORD dwFlags, // размер кучи управляющего указателя флагов LPCVOID lpMem // в память, чтобы возвращать размер для
);


Параметры

hHeap

Определяет кучу в которой блок памяти находится. Эта ручка возвращана HeapCreate или функцией GetProcessHeap.

dwFlags

Определяет несколько управляемых аспектов доступа блока памяти. Только один флаг к настоящему времени определен; тем не менее, все другие величины флага зарезервированы для будущего использования. Определение этого флага аннулирует соответствующий флаг определенный в параметре flOptions когда куча была создана использованием функции HeapCreate:

Значение Величины
HEAP_NO_SERIALIZE Определяет, что взаимное исключение не будет использовано тогда как функция получает кучу. Более подробно о HEAP_NO_SERIALIZE, смотри Замечания для HeapCreate.


lpaam

Точки на блока памяти чей размер функция получит. Это - указатель возвращанный HeapAlloc или функция HeapReAlloc.



Обратные Величины

Если функция добивается успеха, обратная величина является размером, в байтах, размещенного блока памяти.
Если функция терпит неудачу, обратная величина - 0xFFFFFFFF. Функция не называет SetLastError. Приложение не может призвать GetLastError к расширенной информации ошибки.

Смотри Также

GetProcessHeap, HeapAlloc, HeapCreate, HeapDestroy, HeapFree, HeapReAlloc, SetLastError


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz