Função GetAtomNameA (winbase.h)

Artigo
11/20/2024

Recupera uma cópia da cadeia de caracteres associada ao átomo local especificado.

Sintaxe

UINT GetAtomNameA(
  [in]  ATOM  nAtom,
  [out] LPSTR lpBuffer,
  [in]  int   nSize
);

Parâmetros

[in] nAtom

Tipo: ATOM

O átomo local que identifica a cadeia de caracteres a ser recuperada.

[out] lpBuffer

Tipo: LPTSTR

A 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.

Nota

O cabeçalho winbase.h define GetAtomName 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

GlobalGetAtomName

MAKEINTATOM

de referência de

Compartilhar via