Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Descarta el objeto de memoria local especificado. El recuento de bloqueos del objeto de memoria debe ser cero.
Nota Las funciones locales tienen mayor sobrecarga y proporcionan menos características que otras funciones de administración de memoria. Las nuevas aplicaciones deben usar las funciones del montón a menos que la documentación indique que se debe usar una función local. Para obtener más información, consulte Funciones globales y locales.
Sintaxis
HLOCAL LocalDiscard(
[in] HLOCAL h
);
Parámetros
[in] h
Identificador del objeto de memoria local. La función LocalAlloc o LocalReAlloc devuelve este identificador.
Valor devuelto
Tipo: HLOCAL
Si la función se ejecuta correctamente, el valor devuelto es un identificador para el objeto de memoria local. Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.
Observaciones
Aunque LocalDiscard descarta el bloque de memoria del objeto, el identificador del objeto sigue siendo válido. Un proceso puede pasar posteriormente el identificador a la función LocalReAlloc para asignar otro objeto de memoria local identificado por el mismo identificador.
Requisitos
| Requisito | Importancia |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado | minwinbase.h (incluya Windows.h) |