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 |