Função GlobalFlags (winbase.h)

Recupera informações sobre o objeto de memória global especificado.

Nota Essa função é fornecida apenas para compatibilidade com versões de 16 bits do Windows. Novos aplicativos devem usar as funções de heap. Para obter mais informações, consulte Comentários.

 

Sintaxe

UINT GlobalFlags(
  [in] HGLOBAL hMem
);

Parâmetros

[in] hMem

Um identificador para o objeto de memória global. Esse identificador é retornado pela função GlobalAlloc ou GlobalReAlloc .

Retornar valor

Se a função for bem-sucedida, o valor retornado especificará os valores de alocação e a contagem de bloqueios para o objeto de memória.

Se a função falhar, o valor retornado será GMEM_INVALID_HANDLE, indicando que o identificador global não é válido. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O byte de baixa ordem da palavra de baixa ordem do valor retornado contém a contagem de bloqueios do objeto. Para recuperar a contagem de bloqueios do valor retornado, use a máscara GMEM_LOCKCOUNT com o operador AND (&) bit a bit. A contagem de bloqueios de objetos de memória alocados com GMEM_FIXED é sempre zero.

O byte de alta ordem da palavra de baixa ordem do valor retornado indica os valores de alocação do objeto de memória. Pode ser zero ou GMEM_DISCARDED.

As funções globais têm maior sobrecarga e fornecem menos recursos do que outras funções de gerenciamento de memória. Novos aplicativos devem usar as funções heap , a menos que a documentação declare que uma função global deve ser usada. Para obter mais informações, consulte Funções globais e locais.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (incluir Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

Funções globais e locais

Globalalloc

GlobalDiscard

GlobalReAlloc

Funções de gerenciamento da memória