Функция 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) |
См. также раздел
Основные понятия
Справочные материалы