Função LocalFlags (winbase.h)
Recupera informações sobre o objeto de memória local especificado.
Sintaxe
UINT LocalFlags(
[in] HLOCAL hMem
);
Parâmetros
[in] hMem
Um identificador para o objeto de memória local. Esse identificador é retornado pela função LocalAlloc ou LocalReAlloc .
Retornar valor
Se a função for bem-sucedida, o valor retornado especificará os valores de alocação e a contagem de bloqueios para o objeto de memória.
Se a função falhar, o valor retornado será LMEM_INVALID_HANDLE, indicando que o identificador local não é válido. Para obter informações de erro estendidas, chame GetLastError.
Comentários
O byte de baixa ordem da palavra de baixa ordem do valor retornado contém a contagem de bloqueios do objeto. Para recuperar a contagem de bloqueios do valor retornado, use a máscara LMEM_LOCKCOUNT com o operador AND (&) bit a bit. A contagem de bloqueios de objetos de memória alocados com LMEM_FIXED é sempre zero.
O byte de alta ordem da palavra de baixa ordem do valor retornado indica os valores de alocação do objeto de memória. Pode ser zero ou LMEM_DISCARDABLE.
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.
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 |