Função GlobalGetAtomNameA (winbase.h)
Recupera uma cópia da cadeia de caracteres associada ao atom global especificado.
Sintaxe
UINT GlobalGetAtomNameA(
[in] ATOM nAtom,
[out] LPSTR lpBuffer,
[in] int nSize
);
Parâmetros
[in] nAtom
Tipo: ATOM
O átomo global associado à cadeia de caracteres a ser recuperada.
[out] lpBuffer
Tipo: LPTSTR
O buffer para a cadeia de caracteres.
[in] nSize
Tipo: int
O tamanho, em caracteres, do buffer.
Valor retornado
Tipo: UINT
Se a função for bem-sucedida, o valor retornado será o comprimento da cadeia de caracteres copiada para o buffer, em caracteres, sem incluir o caractere nulo de terminação.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
A cadeia de caracteres retornada para um átomo inteiro (um átomo cujo valor está no intervalo 0x0001 para 0xBFFF) é uma cadeia de caracteres terminada em nulo na qual o primeiro caractere é um sinal de libra (#) e os caracteres restantes representam o valor atom inteiro sem sinal.
Considerações sobre segurança
Usar essa função incorretamente pode comprometer a segurança do programa. O uso incorreto dessa função inclui não especificar corretamente o tamanho do parâmetro lpBuffer . Além disso, observe que um átomo global é acessível por qualquer pessoa; portanto, a privacidade e a integridade de seu conteúdo não são garantidas.Observação
O cabeçalho winbase.h define GlobalGetAtomName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [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
Referência