Función LocalReAlloc (winbase.h)

Cambia el tamaño o los atributos de un objeto de memoria local especificado. El tamaño puede aumentar o disminuir.

Sintaxis

DECLSPEC_ALLOCATOR HLOCAL LocalReAlloc(
  [in] _Frees_ptr_opt_ HLOCAL hMem,
  [in] SIZE_T                 uBytes,
  [in] UINT                   uFlags
);

Parámetros

[in] hMem

Identificador del objeto de memoria local que se va a reasignar. La función LocalAlloc o LocalReAlloc devuelve este identificador.

[in] uBytes

Nuevo tamaño del bloque de memoria, en bytes. Si uFlags especifica LMEM_MODIFY, este parámetro se omite.

[in] uFlags

Opciones de reasignación. Si se especifica LMEM_MODIFY , la función modifica los atributos del objeto de memoria solo (se omite el parámetro uBytes ). De lo contrario, la función reasigna el objeto de memoria.

Opcionalmente, puede combinar LMEM_MODIFY con el siguiente valor.

Si este parámetro no especifica LMEM_MODIFY, puede usar el siguiente valor.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el objeto de memoria reasignado.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si se produce un error en LocalReAlloc , la memoria original no se libera y el identificador y el puntero originales siguen siendo válidos.

Si LocalReAlloc reasigna un objeto fijo, el valor del identificador devuelto es la dirección del primer byte del bloque de memoria. Para acceder a la memoria, un proceso simplemente puede convertir el valor devuelto a un puntero.

Requisitos

Vea también

Funciones globales y locales

LocalAlloc

LocalFree

LocalLock

Funciones de administración de memoria