На главную

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 | Скачать Вниз

LocalReAlloc



The LocalReAlloc function changes the size or the attributes of a specified local memory object. The size can increase or decrease.

HLOCAL LocalReAlloc(

HLOCAL hMem, // handle of local memory object
UINT uBytes, // new size of block
UINT uFlags // how to reallocate object
);


Parameters

hMem

Identifies the local memory object to be reallocated. This handle is returned by either the LocalAlloc or LocalReAlloc function.

uBytes

Specifies the new size, in bytes, of the memory block. If this parameter is zero and the uFlags parameter specifies the LMEM_MOVEABLE flag, the function returns a handle to a memory object that is marked as discarded. If uFlags specifies the LMEM_MODIFY flag, this parameter is ignored.

uFlags

Specifies how to reallocate the local memory object. If the LMEM_MODIFY flag is specified, this parameter modifies the attributes of the memory object, and the uBytes parameter is ignored. Otherwise, this parameter controls the reallocation of the memory object.
The LMEM_MODIFY flag can be combined with either or both of the following flags:

Flag Meaning
LMEM_DISCARDABLE
Allocates discardable memory if the LMEM_MODIFY flag is also specified. This flag is ignored, unless the object was previously allocated as movable or the LMEM_MOVEABLE flag is also specified.
LMEM_MOVEABLE
You cannot combine LMEM_MOVEABLE with LMEM_MODIFY to change a fixed memory object into a movable one. The function returns an error if an application attempts this.


If uFlags does not specify LMEM_MODIFY, this parameter can be any combination of the following flags:

Flag Meaning
LMEM_MOVEABLE
If uBytes is zero, discards a previously movable and discardable memory block. If the object's lock count is not zero or the block is not movable and discardable, the function fails.
If uBytes is nonzero, enables the system to move the reallocated block to a new location without changing the movable or fixed attribute of the memory object. If the object is fixed, the handle returned may be different from the handle specified in the hMem parameter. If the object is movable, the block can be moved without invalidating the handle, even if the object is currently locked by a previous call to the LocalLock function. To get the new address of the memory block, use LocalLock.
LMEM_NOCOMPACT
Prevents memory from being compacted or discarded to satisfy the allocation request.
LMEM_ZEROINIT
Causes the additional memory contents to be initialized to zero if the memory object is growing in size.


Return Values

If the function succeeds, the return value is the handle of the reallocated memory object.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

If LocalReAlloc reallocates a movable object, the return value is the handle of the memory object. To convert the handle to a pointer, use the LocalLock function.
If LocalReAlloc reallocates a fixed object, the value of the handle returned is the address of the first byte of the memory block. To access the memory, a process can simply cast the return value to a pointer.

See Also

LocalAlloc, LocalFree, LocalLock


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

LocalReAlloc



Функция LocalReAlloc изменяет размер или атрибуты определенного локального объекта памяти. Размер может увеличить или уменьшаться.

HLOCAL LocalReAlloc(

HLOCAL hMem, // РУЧКА локального объекта памяти UINT uBytes, // новый размер блока UINT uFlags // как, чтобы reallocate объект
);


Параметры

hMem

Идентифицирует локальный объект памяти против reallocated. Эта ручка возвращана или LocalAlloc или функция LocalReAlloc.

uBytes

Определяет новый размер, в байтах, блока памяти. Если этот параметр является нулем и параметр uFlags определяет флаг LMEM_MOVEABLE, функция возвращает ручку на объект памяти, что обозначен как отвергнуто. Если uFlags определяет флаг LMEM_MODIFY, этот параметр проигнорирован.

uFlags

Определяет как, чтобы reallocate локальный объект памяти. Если флаг LMEM_MODIFY определен, этот параметр модифицирует атрибуты объекта памяти, и параметр uBytes проигнорирован. В противном случае, этот параметр регулирует перераспределение объекта памяти.
Флаг LMEM_MODIFY может быть объединен с или обоими следующими флагов:

Сигнализируйте Значение LMEM_DISCARDABLE
Распределяет исключаемую память если флаг LMEM_MODIFY также определен. Этот флаг проигнорирован, если объект прежде не был распределен как подвижный или флаг LMEM_MOVEABLE также определен.
LMEM_MOVEABLE
Вы не можете объединить LMEM_MOVEABLE с LMEM_MODIFY, чтобы изменять фиксированный объект памяти в подвижный. Функция возвращает ошибку если приложение пытается это.


Если uFlags не определяет LMEM_MODIFY, этот параметр может быть любой комбинацией следующего флагов:

Сигнализируйте Значение LMEM_MOVEABLE
Если uBytes - нуль, отвергает прежде подвижного и исключаемого блока памяти. Если объектный счет замка не является нулем или блок - не подвижный и исключаемый, функция терпит неудачу.
Если uBytes ненулевой, позволяет систему, чтобы перемещать reallocated блока на новую позицию не изменяя подвижный или фиксированный атрибут объекта памяти. Если объект установлен, возвращанная ручка может отличаться от ручки определенной в параметре hMem. Если объект подвижный, блок может не быть перемещен аннулируя ручку, даже если бы объект к настоящему времени заперт предшествующим вызовом в функцию LocalLock. Для того, чтобы получать новый адрес блока памяти, используйте LocalLock.
LMEM_NOCOMPACT
Предохраняет память от уплотненное или отвергнутое, чтобы удовлетворять просьбу распределения.
LMEM_ZEROINIT
Вызывает дополнительное содержание памяти, которое нужно инициализироваться в нуль если объект памяти растет по величине.


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

Если функция добивается успеха, обратная величина является ручкой reallocated объекта памяти.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Если LocalReAlloc reallocates подвижный объект, обратная величина является ручкой объекта памяти. Для того, чтобы преобразовывать ручку на указатель, используйте функцию LocalLock.
Если LocalReAlloc reallocates фиксированный объект, величина возвращанной ручки - адрес первого байта блока памяти. Чтобы иметь доступ к памяти, процесс может просто бросить обратную величину на указатель.

Смотри Также

LocalAlloc, LocalFree, LocalLock


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