Поделиться через


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

Отменяет регистрацию класса окна, освобождая память, необходимую для класса .

Синтаксис

BOOL UnregisterClassW(
  [in]           LPCWSTR   lpClassName,
  [in, optional] HINSTANCE hInstance
);

Параметры

[in] lpClassName

Тип: LPCTSTR

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

[in, optional] hInstance

Тип: HINSTANCE

Дескриптор экземпляра модуля, создавшего класс .

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

Тип: BOOL

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

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

Комментарии

Перед вызовом этой функции приложение должно уничтожить все окна, созданные с помощью указанного класса.

Все классы окон, регистрируемые приложением, отменяются при завершении его работы.

Атомы класса — это специальные атомы, возвращаемые только RegisterClass и RegisterClassEx.

При выгрузке .dll не отменяются регистрация оконных классов, зарегистрированных библиотекой DLL.

Примечание

Заголовок winuser.h определяет UnregisterClass в качестве псевдонима, который автоматически выбирает версию 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)

См. также раздел

Основные понятия

Справочные материалы

RegisterClass

RegisterClassEx

Классы окон