Отмена регистрации функцииClassA (winuser.h)
Отменяет регистрацию класса окна, освобождая память, необходимую для класса.
Синтаксис
BOOL UnregisterClassA(
[in] LPCSTR lpClassName,
[in, optional] HINSTANCE hInstance
);
Параметры
[in] lpClassName
Тип: LPCTSTR
Строка, завершающаяся значением NULL или атомом класса. Если lpClassName является строкой, он указывает имя класса окна. Это имя класса должно быть зарегистрировано предыдущим вызовом функции registerClass или RegisterClassEx. Системные классы, такие как элементы управления диалоговым окном, нельзя отменить регистрацию. Если этот параметр является атомом, он должен быть атомом класса, созданным предыдущим вызовом функции RegisterClass или RegisterClassEx. Атом должен находиться в слове с низким порядком lpClassName; Слово с высоким порядком должно быть равно нулю.
[in, optional] hInstance
Тип: HINSTANCE
Дескриптор экземпляра модуля, создавшего класс.
Возвращаемое значение
Тип: BOOL
Если функция выполнена успешно, возвращаемое значение ненулевое.
Если класс не удалось найти или если окно по-прежнему существует с помощью класса, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Перед вызовом этой функции приложение должно уничтожить все окна, созданные с указанным классом.
Все классы окон, регистрируемые приложением, отменяются при завершении работы.
Атомы класса являются специальными атомами, возвращаемыми только RegisterClass и RegisterClassEx.
Классы окон, зарегистрированные библиотекой DLL, не регистрируются при выгрузке .dll.
Заметка
Заголовок winuser.h определяет UnregisterClass как псевдоним, который автоматически выбирает версию 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) |
См. также
концептуальные
Справочник