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

Статья
08/27/2023

Извлекает сведения о классе окна.

Примечание Функция GetClassInfo была заменена функцией GetClassInfoEx . Однако вы по-прежнему можете использовать GetClassInfo, если вам не нужны сведения о маленьком значке класса.

Синтаксис

BOOL GetClassInfoA(
  [in, optional] HINSTANCE   hInstance,
  [in]           LPCSTR      lpClassName,
  [out]          LPWNDCLASSA lpWndClass
);

Параметры

[in, optional] hInstance

Тип: HINSTANCE

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

[in] lpClassName

Тип: LPCTSTR

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

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

[out] lpWndClass

Тип: LPWNDCLASS

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

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

Тип: BOOL

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	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)