winbase.h


GlobalDiscard

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

Sintaxis

HGLOBAL GlobalDiscard(
    HGLOBAL hgblMem  // manipulador de objeto de memoria global
   );

Parámetros:

hgblMem: identifica el objeto de memoria global. Este manipulador es devuelto por las funciones GlobalAlloc o GlobalReAlloc.

Valor de retorno

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

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

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

Aunque GlobalDiscard 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 global identificado con el mismo manipulador.