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

Статья
11/20/2024

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

Примечание функция 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll
набор API	ext-ms-win-ntuser-windowclass-l1-1-0 (представлено в Windows 8)