Функция UnregisterClass


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

Синтаксис

BOOL UnregisterClass(      
    LPCTSTR lpClassName,
    HINSTANCE hInstance
);

Параметры

lpClassName

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

hInstance

[in] Дескриптор экземпляра модуля, который создал класс.

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

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

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

Замечания

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

Когда приложение завершает работу, у всех классов окна, которые оно зарегистрировало, отменяется регистрация.

Атомы класса - это специальные атомы, возвращаются только функцией RegisterClass и RegisterClassEx.

Когда динамически подключаемая библиотека (DLL) выгружается, у всех классов окна, которые DLL зарегистрировала, отменяется регистрация.

Ни один класс окна, зарегистрированный  DLL, не становиться незарегистрированным, когда .dll выгружается. 

Функция UnregisterClassW поддерживается Microsoft Layer for Unicode (MSLU). Чтобы использовать эту версию, Вы должны добавить некоторые файлы в ваше приложение, как это изложено в Microsoft Layer for Unicode для систем Windows 95/98/Me.

Смотри также

Обзор Классы окна, Функции, используемые классами окна, RegisterClass, RegisterClassEx

Размещение и совместимость UnregisterClass

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz