Compartilhar via


Função LocalSize (winbase.h)

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

Nota As funções locais 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 local deve ser usada. Para obter mais informações, consulte Funções globais e locais.
 

Sintaxe

SIZE_T LocalSize(
  [in] HLOCAL hMem
);

Parâmetros

[in] hMem

Um identificador para o objeto de memória local. Esse identificador é retornado pela função LocalAlloc, LocalReAlloc ou LocalHandle .

Retornar valor

Se a função for bem-sucedida, o valor retornado será o tamanho do objeto de memória local 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, chame a função LocalFlags antes de chamar LocalSize.

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

Localalloc

LocalFlags

LocalHandle

Localrealloc

Funções de gerenciamento da memória