Função GlobalGetAtomNameA (winbase.h)

Artigo
08/27/2023

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