Функция FindWindowA (winuser.h)

Статья
05/30/2024

Извлекает дескриптор в окно верхнего уровня, имя класса и имя окна которого соответствуют указанным строкам. Эта функция не выполняет поиск дочерних окон. Эта функция не выполняет поиск с учетом регистра.

Для поиска дочерних окон, начиная с указанного дочернего окна, используйте функцию FindWindowEx .

Синтаксис

HWND FindWindowA(
  [in, optional] LPCSTR lpClassName,
  [in, optional] LPCSTR lpWindowName
);

Параметры

[in, optional] lpClassName

Тип: LPCTSTR

Имя класса или атом класса, созданный при предыдущем вызове функции RegisterClass или RegisterClassEx . Атом должен быть в нижнем порядке слово lpClassName; Слово высокого порядка должно быть равно нулю.

Если lpClassName указывает на строку, она указывает имя класса окна. Имя класса может быть любым именем, зарегистрированным с помощью RegisterClass или RegisterClassEx, или любым из предопределенных имен классов элементов управления.

Если lpClassName имеет значение NULL, оно находит любое окно, заголовок которого соответствует параметру lpWindowName .

[in, optional] lpWindowName

Тип: LPCTSTR

Имя окна (заголовок окна). Если этот параметр имеет значение NULL, все имена окон совпадают.

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

Тип: HWND

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

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

Если параметр lpWindowName не имеет значение NULL, FindWindow вызывает функцию GetWindowText , чтобы получить имя окна для сравнения. Описание потенциальной проблемы, которая может возникнуть, см. в разделе Примечания для GetWindowText.

Примеры

Пример см. в разделе Получение числа линий прокрутки колесика мыши.

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-0 (появилось в Windows 8)