LocalFree
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função libera o local especificado objeto memória e invalida o identificador.
Syntax
HLOCAL LocalFree(
HLOCAL hMem
);
Parameters
hMem
Identificador para o local objeto memória.Esse identificador é retornado pelo LocalAlloc ou LocalReAlloc função.
Return Value
NULL Indica sucesso. Um identificador para o local memória objeto indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Se o processo tentar examinar ou modificar a memória após ela é liberada, heap dano pode ocorrer ou uma exceção violação de acesso (EXCEPTION_ACCESS_VIOLATION) pode ser gerada.
Se a pasta hMem parâmetro é NULL, LocalFree ignora o parâmetro e retorna NULL.
O LocalFree função será livre um objeto memória bloqueada. Um objeto memória bloqueada possui uma contagem bloqueio maior que zero.
Se um aplicativo é execução em uma versão depuração do sistema, LocalFree Emite uma mensagem que informa que um objeto bloqueado está sendo liberado. Se você estiver depuração de aplicativo, LocalFree Insere uma ponto de interrupção apenas antes de liberar um objeto bloqueado. Isso permite que você verificar o comportamento desejado e continue a execução.
Alocar memória cerca de 0 a 7 bytes em 192K no tamanho faz com que o correspondente Windows CE 1.0 a Windows CE 2.12, chamar a LocalFree Para falhar para determinados memória bloqueia no intervalo tamanho. O código de retorno é ERROR_INVALID_PARAMETER.
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |