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

Статья
03/04/2024

Извлекает сведения о классе окна, включая дескриптор небольшого значка, связанного с классом окна. Функция GetClassInfo не извлекает дескриптор маленького значка.

Синтаксис

BOOL GetClassInfoExA(
  [in, optional] HINSTANCE     hInstance,
  [in]           LPCSTR        lpszClass,
  [out]          LPWNDCLASSEXA lpwcx
);

Параметры

[in, optional] hInstance

Тип: HINSTANCE

Дескриптор экземпляра приложения, создавшего класс . Чтобы получить сведения о классах, определенных системой (например, кнопках или списках), задайте для этого параметра значение NULL.

[in] lpszClass

Тип: LPCTSTR

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

[out] lpwcx

Тип: LPWNDCLASSEX

Указатель на структуру WNDCLASSEX , которая получает сведения о классе.

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

Тип: BOOL

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

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

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

Требования

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