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

Статья
11/20/2024

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

Синтаксис

BOOL GetClassInfoExW(
  [in, optional] HINSTANCE     hInstance,
  [in]           LPCWSTR       lpszClass,
  [out]          LPWNDCLASSEXW lpwcx
);

Параметры

[in, optional] hInstance

Тип: HINSTANCE

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

[in] lpszClass

Тип: LPCTSTR

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

[out] lpwcx

Тип: LPWNDCLASSEX

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

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

Тип: BOOL

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

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

Замечания

Атомы классов создаются с помощью функции RegisterClass или registerClassEx, а не функции GlobalAddAtom.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	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)