Функция GlobalFindAtomA (winbase.h)
Выполняет поиск глобальной таблицы atom для указанной строки символов и извлекает глобальный атом, связанный с этой строкой.
Синтаксис
ATOM GlobalFindAtomA(
[in] LPCSTR lpString
);
Параметры
[in] lpString
Тип: LPCTSTR
Строка символов, завершающаяся значением NULL, для которой выполняется поиск.
Кроме того, можно использовать целый атом, который был преобразован с помощью макроса MAKEINTATOM. Дополнительные сведения см. в примечаниях.
Возвращаемое значение
Тип: ATOM
Если функция выполнена успешно, возвращаемое значение является глобальным атомом, связанным с заданной строкой.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Несмотря на то что система сохраняет регистр строки в таблице atom, так как она была введена первоначально, поиск, выполняемый GlobalFindAtom не учитывает регистр.
Если lpString создан макросом MAKEINTATOM, слово с низким порядком должно находиться в диапазоне 0x0001 через 0xBFFF. Если слово с низким порядком не находится в этом диапазоне, функция завершается ошибкой.
Заметка
Заголовок winbase.h определяет GlobalFindAtom как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | winbase.h (включая Windows.h) |
| библиотеки |
Kernel32.lib |
| DLL | Kernel32.dll |
См. также
Справочник