Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.winnt.rsm.org.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.winnt.rsm.org.ru/winapi/winapi.htm
Раздел "C++Builder": http://www.winnt.rsm.org.ru/cbuilder/cbuilder.htm
Раздел "Советы & примеры": http://www.winnt.rsm.org.ru/tipstricks/tipstricks.htm
Обновления на сайте
Нет.
Перевод
Сегодня вашему вниманию представлен перевод функции HeapSize.
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.
Возвращаемые значения
В случае успеха возвращается размер выделенного блока памяти в байтах.
В случае неудачи возвращается 0xFFFFFFFF. Функция не вызывает SetLastError.
Приложение не может вызвать GetLastError для дополнительной информации об ошибке.
См. также
GetProcessHeap, HeapAlloc, HeapCreate, HeapDestroy, HeapFree, HeapReAlloc, SetLastError.
хелп по WinAPI: http://www.winnt.rsm.org.ru/winapi/winapirefresh.htm
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru