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

Статья
03/13/2024

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

Синтаксис

ATOM GlobalFindAtomW(
  [in] LPCWSTR lpString
);

Параметры

[in] lpString

Тип: LPCTSTR

Строка символов, завершающаяся null, для которой выполняется поиск.

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

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

Тип: ATOM

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

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

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

Примечание

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

Требования

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