Função GlobalSize (winbase.h)

Artigo
08/27/2023

Recupera o tamanho atual do objeto de memória global especificado, em bytes.

Nota 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.

Sintaxe

SIZE_T GlobalSize(
  [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 será o tamanho do objeto de memória global especificado, em bytes.

Se o identificador especificado não for válido ou se o objeto tiver sido descartado, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O tamanho de um bloco de memória pode ser maior do que o tamanho solicitado quando a memória foi alocada.

Para verificar se o bloco de memória do objeto especificado não foi descartado, use a função GlobalFlags antes de chamar GlobalSize.

Requisitos

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