| |||
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! | |||
| |||
HeapReAllocThe HeapReAlloc function reallocates a block of memory from a heap. This function enables you to resize a memory block and change other memory block properties. The allocated memory is not movable. LPVOID HeapReAlloc( HANDLE hHeap, // handle to a heap block DWORD dwFlags, // heap reallocation flags LPVOID lpMem, // pointer to the memory to reallocate DWORD dwBytes // number of bytes to reallocate ); Parameters hHeap Specifies the heap from which the memory will be reallocated. This is a handle returned by the HeapCreate or GetProcessHeap function. dwFlags Specifies several controllable aspects of heap reallocation. Specifying any of these flags will override the corresponding flag specified in the flOptions parameter when the heap was created by using the HeapCreate function. You can specify one or more of the following flags: Flag Meaning HEAP_GENERATE_EXCEPTIONS Specifies that the operating-system will raise an exception to indicate a function failure, such as an out-of-memory condition, instead of returning NULL. HEAP_NO_SERIALIZE Specifies that mutual exclusion will not be used while this function is accessing the heap. For more information about HEAP_NO_SERIALIZE, see the Remarks section of HeapCreate. HEAP_REALLOC_IN_PLACE_ONLY Specifies that there can be no movement when reallocating a memory block to a larger size. If this flag is not specified and the reallocation request is for a larger size, the function may move the block to a new location. If this flag is specified and the block cannot be enlarged without moving, the function will fail, leaving the original memory block unchanged. HEAP_ZERO_MEMORY If the reallocation request is for a larger size, this flag specifies that the additional region of memory beyond the original size will be initialized to zero. The contents of the memory block up to its original size are unaffected. lpMem Points to the block of memory that the function reallocates. This pointer is returned by an earlier call to the HeapAlloc or HeapReAlloc function. dwBytes Specifies the new size of the memory block, in bytes. A memory block's size can be increased or decreased by using this function. If the heap specified by the hHeap parameter is a "non-growable" heap, dwBytes must be less than 0x7FFF8. You create a non-growable heap by calling the HeapCreate function with a nonzero value. Return Values If the function succeeds, the return value is a pointer to the reallocated memory block. If the function fails and you have not specified HEAP_GENERATE_EXCEPTIONS, the return value is NULL. If the function fails and you have specified HEAP_GENERATE_EXCEPTIONS, the function may generate the following exceptions: Value Meaning STATUS_NO_MEMORY The reallocation attempt failed for lack of available memory. STATUS_ACCESS_VIOLATION The reallocation attempt failed because of heap corruption or improper function parameters. If the function fails, it calls SetLastError. An application can call GetLastError for extended error information. Remarks If HeapReAlloc succeeds, it allocates at least the amount of memory requested. If the actual amount allocated is greater than the amount requested, the process can use the entire amount. To determine the actual size of the reallocated block, use the HeapSize function. To free a block of memory allocated by HeapReAlloc, use the HeapFree function. See Also GetProcessHeap, HeapAlloc, HeapCreate, HeapDestroy, HeapFree, HeapSize, SetLastError | |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
| |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
HeapReAllocФункция HeapReAlloc reallocates блок памяти из кучи. Эта функция позволяет Вам, чтобы менять размеры блока памяти и изменять другие блочные свойства памяти. Размещенная память не подвижная. LPVOID HeapReAlloc( РУЧКА hHeap, // оперируется блоку кучи DWORD dwFlags, // перераспределение кучи сигнализирует LPVOID lpMem, // указатель в память в reallocate количество DWORD dwBytes // байтов на reallocate ); Параметры hHeap Определяет кучу из которой память reallocated. Это - ручка возвращанная HeapCreate или функция GetProcessHeap. dwFlags Определяет несколько управляемых аспектов перераспределения кучи. Определяя любой из этих флагов аннулирует соответствующий флаг определенный в параметре flOptions когда куча была создана использованием функции HeapCreate. Вы можете определить одно или более из следующего флагов: Значение Флага HEAP_GENERATE_EXCEPTIONS Определяет, что операционная система поднимет исключение, чтобы указывать функциональную неудачу, как например,--условие память, вместо обратного НЕДЕЙСТВИТЕЛЬНОГО. HEAP_NO_SERIALIZE Определяет, что взаимное исключение не будет использовано тогда как эта функция получает кучу. Более подробно о HEAP_NO_SERIALIZE, смотри секцию Замечаний HeapCreate. HEAP_REALLOC_IN_PLACE_ONLY Определяет, что может не быть никаким перемещением reallocating блок памяти в больший размер. Если этот флаг не определен и просьба перераспределения - для большего размера, функция может переместить блока на новую позицию. Если этот флаг определен и блок не может не быть расширен перемещая, функция потерпит неудачу, отъезд оригинальной памяти блочный неизменный. HEAP_ZERO_MEMORY Если просьба перераспределения - для большего размера, этот флаг определяет, что дополнительный регион памяти за оригинальным размером будет инициализирован в нуль. Содержание памяти блокирует в свой оригинальный размер просты. lpMem Точки на блока памяти это функция reallocates. Этот указатель возвращан более ранним вызовом в HeapAlloc или функцию HeapReAlloc. dwBytes Определяет новый размер блока памяти, в байтах. Блочный размер памяти может быть повышен или уменьшен использованием этой функции. Если куча определенная параметром hHeap - куча "не-growable", dwBytes должен быть менее чем 0x7FFF8. Вы создаете не-growable кучу вызывая функцию HeapCreate с ненулевой величиной. Обратные Величины Если функция добивается успеха, обратная величина является указателем reallocated блоку памяти. Если функция терпит неудачу и Вы не определили HEAP_GENERATE_EXCEPTIONS, обратная величина НЕДЕЙСТВИТЕЛЬНА. Если функция терпит неудачу и, Вы определили HEAP_GENERATE_EXCEPTIONS, функция может сгенерировать следующие исключения: Значение Величины STATUS_NO_MEMORY попытка перераспределения терпела неудачу из-за отсутствия доступной памяти. STATUS_ACCESS_VIOLATION попытка перераспределения терпела неудачу из-за коррупции кучи или неправильных функциональных параметров. Если функция терпит неудачу, она называет SetLastError. Приложение может призвать GetLastError к расширенной информации ошибки. Замечания Если HeapReAlloc добивается успеха, это распределяет по крайней мере сумму запрошенной памяти. Если размещенная фактическая сумма больше, чем сумма запрашивалась, процесс может использовать целую сумму. Для того, чтобы определять фактический размер reallocated блока, используйте функцию HeapSize. Для того, чтобы освобождать блока памяти распределенной HeapReAlloc, используйте функцию HeapFree. Смотри Также GetProcessHeap, HeapAlloc, HeapCreate, HeapDestroy, HeapFree, HeapSize, SetLastError | |||
| |||
 |
