Compartilhar via


Função GlobalHandle (winbase.h)

Recupera o identificador associado ao ponteiro especificado para um bloco de memória global.

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

HGLOBAL GlobalHandle(
  [in] LPCVOID pMem
);

Parâmetros

[in] pMem

Um ponteiro para o primeiro byte do bloco de memória global. Esse ponteiro é retornado pela função GlobalLock .

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para o objeto de memória global especificado.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Quando a função GlobalAlloc aloca um objeto de memória com GMEM_MOVEABLE, ela retorna um identificador para o objeto . A função GlobalLock converte esse identificador em um ponteiro para o bloco de memória e GlobalHandle converte o ponteiro de volta em um identificador.

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 (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções globais e locais

Globalalloc

GlobalLock

Funções de gerenciamento da memória