Função GlobalAddAtomExW (winbase.h)

Artigo
11/20/2024

Adiciona uma cadeia de caracteres à tabela atom global e retorna um valor exclusivo (um átomo) que identifica a cadeia de caracteres.

Sintaxe

ATOM GlobalAddAtomExW(
  [in, optional] LPCWSTR lpString,
  [in]           DWORD   Flags
);

Parâmetros

[in, optional] lpString

A cadeia de caracteres terminada em nulo a ser adicionada. A cadeia de caracteres pode ter um tamanho máximo de 255 bytes. As cadeias de caracteres que diferem apenas no caso são consideradas idênticas. O caso da primeira cadeia de caracteres desse nome adicionado à tabela é preservado e retornado pela função GlobalGetAtomName.

Como alternativa, você pode usar um átomo inteiro que foi convertido usando a macro MAKEINTATOM . Consulte os Comentários para obter mais informações.

[in] Flags

Valor de retorno

Se a função for bem-sucedida, o valor retornado será o átomo recém-criado.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

Nota

O cabeçalho winbase.h define GlobalAddAtomEx 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
da Plataforma de Destino	Windows
cabeçalho	winbase.h (inclua Windows.h)
biblioteca	Kernel32.lib
de DLL	Kernel32.dll

Consulte também

GlobalAddAtom

Compartilhar via