Compartilhar via

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

AddAtom

DeleteAtom

FindAtom

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

MAKEINTATOM

de referência de

  • Last updated on