Compartir a través de


Función LocalFlags (winbase.h)

Recupera información sobre el objeto de memoria local especificado.

Nota Esta función solo se proporciona por compatibilidad con versiones de 16 bits de Windows. Las nuevas aplicaciones deben usar las funciones del montón. Para obtener más información, vea la sección Comentarios.
 

Sintaxis

UINT LocalFlags(
  [in] HLOCAL hMem
);

Parámetros

[in] hMem

Identificador del objeto de memoria local. Este identificador lo devuelve la función LocalAlloc o LocalReAlloc .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto especifica los valores de asignación y el recuento de bloqueos para el objeto de memoria.

Si se produce un error en la función, el valor devuelto es LMEM_INVALID_HANDLE, lo que indica que el identificador local no es válido. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El byte de orden bajo de la palabra de orden inferior del valor devuelto contiene el recuento de bloqueos del objeto. Para recuperar el recuento de bloqueos del valor devuelto, use la máscara de LMEM_LOCKCOUNT con el operador AND (&) bit a bit. El recuento de bloqueos de objetos de memoria asignados con LMEM_FIXED siempre es cero.

El byte de orden superior de la palabra de orden inferior del valor devuelto indica los valores de asignación del objeto de memoria. Puede ser cero o LMEM_DISCARDABLE.

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, vea Funciones globales y locales.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones globales y locales

GlobalFlags

LocalAlloc

LocalDiscard

LocalLock

LocalReAlloc

LocalUnlock

Funciones de administración de memoria