winbase.h


LocalDiscard

La función LocalDiscard descarta el objeto de memoria local especificado. El contador de bloqueo del objeto de memoria debe ser cero.

Sintaxis

HLOCAL LocalDiscard(
    HLOCAL hlocMem  // manipulador de objeto de memoria local
   );

Parámetros:

hlocMem: identifica el objeto de memoria local. Este manipulador es devuelto por las funciones LocalAlloc o LocalReAlloc.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el manipulador del objeto de memoria local.

Si la función falla, el valor de retorno es NULL. Para obtener información más detallada sobre el error, llamar a la función GetLastError.

Observaciones

LocalDiscard descarta sólo objetos locales reservados por un proceso con la bandera LMEM_DISCARDABLE. Si un proceso intenta descartar un objeto fijo o bloqueado, la función falla.

Aunque LocalDiscard descarta el bloque de memoria del objeto, el manipulador de ese objeto sigue siendo válido. El proceso puede, más adelante, pasar el manipulador a la función LocalReAlloc para reservar otro objeto de memoria local identificado con el mismo manipulador.