Função GlobalGetAtomNameA (winbase.h)
Recupera uma cópia da cadeia de caracteres associada ao átomo 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 da cadeia de caracteres.
[in] nSize
Tipo: int
O tamanho, em caracteres, do buffer.
Valor de retorno
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, não incluindo 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.
Observações
A cadeia de caracteres retornada para um átomo inteiro (um átomo cujo valor está no intervalo 0x0001 a 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 seu 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 estão garantidas.Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winbase.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |
Consulte também
de referência de