取消註冊窗口類別,釋放 類別所需的記憶體。
語法
BOOL UnregisterClassA(
[in] LPCSTR lpClassName,
[in, optional] HINSTANCE hInstance
);
參數
[in] lpClassName
類型:LPCTSTR
以 Null 結束的字串或類別 Atom。 如果 lpClassName 為字串,它會指定視窗類別名稱。 這個類別名稱必須由先前呼叫 registerClass 或
[in, optional] hInstance
類型:HINSTANCE
建立類別之模組實例的句柄。
傳回值
類型:BOOL
如果函式成功,則傳回值為非零值。
如果找不到類別,或如果某個視窗仍存在以 類別建立的視窗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
言論
呼叫此函式之前,應用程式必須終結以指定類別建立的所有視窗。
應用程式註冊的所有視窗類別在終止時都會取消註冊。
類別原子是只有 registerClass
卸除 .dll 時,不會取消註冊 DLL 所註冊的窗口類別。
注意
winuser.h 標頭會將 UnregisterClass 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winuser.h (包括 Windows.h) |
| 連結庫 | User32.lib |
| DLL | User32.dll |
| API 集 | ext-ms-win-ntuser-windowclass-l1-1-0 (在 Windows 8 中引進) |
另請參閱
概念
參考