Função FindAtomA (winbase.h)

Pesquisa a tabela atom local para a cadeia de caracteres especificada e recupera o átomo associado a essa cadeia de caracteres.

Sintaxe

ATOM FindAtomA(
  [in] LPCSTR lpString
);

Parâmetros

[in] lpString

Tipo: LPCTSTR

A cadeia de caracteres para a qual pesquisar.

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

Valor de retorno

Tipo: ATOM

Se a função for bem-sucedida, o valor retornado será o átomo associado à cadeia de caracteres fornecida.

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

Observações

Embora o sistema preserve o caso de uma cadeia de caracteres em uma tabela atom, a pesquisa executada pela função FindAtom não diferencia maiúsculas de minúsculas.

Se lpString foi criado pela macro MAKEINTATOM, a palavra de baixa ordem deverá estar no intervalo 0x0001 até 0xBFFF. Se a palavra de ordem baixa não estiver nesse intervalo, a função falhará.

Nota

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

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

de referência de