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