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)

另請參閱

概念

參考

RegisterClass

RegisterClassEx

窗口類別