Función LocalFlags (winbase.h)

Artículo
03/03/2024

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