Función GlobalFlags (winbase.h)

  • Artículo

Recupera información sobre el objeto de memoria global 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 GlobalFlags(
  [in] HGLOBAL hMem
);

Parámetros

[in] hMem

Identificador del objeto de memoria global. Este identificador lo devuelve la función GlobalAlloc o GlobalReAlloc .

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 GMEM_INVALID_HANDLE, lo que indica que el identificador global 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 GMEM_LOCKCOUNT con el operador AND (&) bit a bit. El recuento de bloqueos de objetos de memoria asignados con GMEM_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 GMEM_DISCARDED.

Las funciones globales 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 global. 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

GlobalAlloc

GlobalDiscard

GlobalReAlloc

Funciones de administración de memoria