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

  • Статья

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

Синтаксис

BOOL UnregisterClassA(
  [in]           LPCSTR    lpClassName,
  [in, optional] HINSTANCE hInstance
);

Параметры

[in] lpClassName

Тип: LPCTSTR

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

[in, optional] hInstance

Тип: HINSTANCE

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

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

Тип: BOOL

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

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

Комментарии

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

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

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

Никакие классы окон, зарегистрированные библиотекой DLL, не регистрируются при выгрузке .dll.

Примечание

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

Требования

Требование Значение
Минимальная версия клиента 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

Классы окон