UnregisterClass
The UnregisterClass
function removes a window class, freeing the memory required for the class.
BOOL UnregisterClass(
|
LPCTSTR lpClassName, |
// address of class
name string |
|
HINSTANCE hInstance |
// handle of
application instance |
|
); |
|
Parameters
lpClassName
Points to a
null-terminated string or is an integer atom. If this parameter is an integer
atom, it must be a global atom created by a previous call to the GlobalAddAtom function. The atom, a
16-bit value less than 0xC000, must be in the low-order word of lpClassName;
the high-order word must be zero.
If lpClassName
is a string, it specifies the window class name. This class name must have been
registered by a previous call to the RegisterClass function. System global
classes, such as dialog box controls, cannot be unregistered.
hInstance
Identifies
the instance of the module that created the class.
Return Values
If the
function succeeds, the return value is nonzero.
If the class
could not be found or if a window still exists that was created with the class,
the return value is zero. To get extended error information, call GetLastError.
Remarks
Before
calling this function, an application must destroy all windows created with the
specified class.
All window
classes that an application registers are unregistered when it terminates.
See Also