Função GlobalSize (winbase.h)
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 |