winbase.h


GlobalFlags

La función GlobalFlags devuelve información sobre el objeto de memoria global especificado.

Sintaxis

UINT GlobalFlags(
    HGLOBAL hMem  // manipilador de objeto de memoria global
   );

Parámetros:

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

Valor de retorno

Si la función tiene éxito, el valor de retorno es un valor de 32 bits que especifica las banderas de localización y el contador de bloqueos para el objeto de memoria.

Si la función falla, el valor de retorno es la bandera GMEM_INVALID_HANDLE, que indica que el manipulador global no es válido. Para obtener información más detallada sobre el error, llamar a la función GetLastError.

Observaciones

El byte de menor peso de la palabra de menor peso del valor de retorno contiene el contador de bloqueos del objeto. Para recuperar el contador de bloqueos a partir del valor de retorno, usar la máscara GMEM_LOCKCOUNT con el operador de bits AND (&). El contador de bloqueo de los objetos de memoria reservados con la bandera GMEM_FIXED siempre es cero.

El byte de mayor peso de la palabra de menor peso del valor de retorno indica las banderas de localización del objeto de memoria. Puede ser cero o cualquier combinación de las siguientes banderas:

Valor Descripción
GMEM_DDESHARE la memoria fue reservada para ser usada por funciones de intercambio dinámico de datos (DDE). Al contrario que Winndows 3.x, esta memoria no es compartida de forma global. Sin embargo, esta bandera está disponible por compatibilidad y puede ser usada por algunas aplicaciones para mejorar el comportamiento de las operaciones DDE. Sólo los procesos que usen DDE o el portapapeles para hacer comunicación entre procesos deben especificar esta bandera.
GMEM_DISCARDABLE El bloque de memoria del objeto puede ser descartado.
GMEM_DISCARDED El bloque del memoria del objeto ha sido descartado.