Función LocalFree (winbase.h)
Libera el objeto de memoria local especificado y invalida su identificador.
HLOCAL LocalFree(
[in] _Frees_ptr_opt_ HLOCAL hMem
);
[in] hMem
Identificador del objeto de memoria local. La función LocalAlloc o LocalReAlloc devuelve este identificador. No es seguro liberar memoria asignada con GlobalAlloc.
Si la función se ejecuta correctamente, el valor devuelto es NULL.
Si se produce un error en la función, el valor devuelto es igual a un identificador para el objeto de memoria local. Para obtener información de error extendida, llame a GetLastError.
Si el proceso intenta examinar o modificar la memoria después de liberarla, se pueden producir daños en el montón o se puede generar una excepción de infracción de acceso (EXCEPTION_ACCESS_VIOLATION).
Si el parámetro hMem es NULL, LocalFree omite el parámetro y devuelve NULL.
La función LocalFree liberará un objeto de memoria bloqueado. Un objeto de memoria bloqueada tiene un recuento de bloqueos mayor que cero. La función LocalLock bloquea un objeto de memoria local e incrementa el recuento de bloqueos en uno. La función LocalUnlock lo desbloquea y disminuye el recuento de bloqueos por uno. Para obtener el recuento de bloqueos de un objeto de memoria local, use la función LocalFlags .
Si una aplicación se ejecuta en una versión de depuración del sistema, LocalFree emitirá un mensaje que indica que se libera un objeto bloqueado. Si está depurando la aplicación, LocalFree escribirá un punto de interrupción justo antes de liberar un objeto bloqueado. Esto le permite comprobar el comportamiento previsto y, a continuación, continuar la ejecución.
Para obtener un ejemplo, vea LocalAlloc.
Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | winbase.h (incluya Windows.h) |
Library | Kernel32.lib |
Archivo DLL | Kernel32.dll |