Поделиться через


Функция FindAtomA (winbase.h)

Выполняет поиск указанной строки символов в локальной таблице atom и извлекает атом, связанный с этой строкой.

Синтаксис

ATOM FindAtomA(
  [in] LPCSTR lpString
);

Параметры

[in] lpString

Тип: LPCTSTR

Строка символов, по которой выполняется поиск.

Кроме того, можно использовать целочисленный атом, преобразованный с помощью макроса MAKEINTATOM . Дополнительные сведения см. в разделе "Примечания".

Возвращаемое значение

Тип: ATOM

Если функция выполняется успешно, возвращаемое значение представляет собой атом, связанный с заданной строкой.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Несмотря на то, что система сохраняет регистр строки в таблице atom, поиск, выполняемый функцией FindAtom , не учитывает регистр.

Если lpString был создан макросом MAKEINTATOM , слово нижнего порядка должно находиться в диапазоне 0x0001 до 0xBFFF. Если слово нижнего порядка не находится в этом диапазоне, функция завершается ошибкой.

Примечание

Заголовок winbase.h определяет FindAtom в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

AddAtom

DeleteAtom

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

Справочные материалы