UnregisterClassW-Funktion (winuser.h)

Hebt die Registrierung einer Fensterklasse auf, wobei der für die Klasse erforderliche Arbeitsspeicher freigegeben wird.

Syntax

BOOL UnregisterClassW(
  [in]           LPCWSTR   lpClassName,
  [in, optional] HINSTANCE hInstance
);

Parameter

[in] lpClassName

Typ: LPCTSTR-

Eine mit Null beendete Zeichenfolge oder ein Klassenatom. Wenn lpClassName- eine Zeichenfolge ist, gibt sie den Namen der Fensterklasse an. Dieser Klassenname muss durch einen vorherigen Aufruf der RegisterClass- oder RegisterClassEx--Funktion registriert worden sein. Systemklassen, z. B. Dialogfeld-Steuerelemente, können nicht aufgehoben werden. Wenn dieser Parameter ein Atom ist, muss es sich um ein Klassenatom handeln, das durch einen vorherigen Aufruf der RegisterClass- oder RegisterClassEx--Funktion erstellt wurde. Das Atom muss sich im Wort "low-order" von lpClassName; Das Wort "Hochreihenfolge" muss null sein.

[in, optional] hInstance

Typ: HINSTANCE-

Ein Handle für die Instanz des Moduls, das die Klasse erstellt hat.

Rückgabewert

Typ: BOOL-

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Klasse nicht gefunden werden konnte oder wenn noch ein Fenster vorhanden ist, das mit der Klasse erstellt wurde, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Vor dem Aufrufen dieser Funktion muss eine Anwendung alle Fenster zerstören, die mit der angegebenen Klasse erstellt wurden.

Alle Fensterklassen, die eine Anwendung registriert, werden beim Beenden nicht registriert.

Klassenatome sind spezielle Atome, die nur von RegisterClass und RegisterClassEx-zurückgegeben werden.

Beim Entladen des .dll werden keine Fensterklassen aufgehoben, die von einer DLL registriert wurden.

Anforderungen

Siehe auch

Konzeptionelle

Referenz-

RegisterClass

RegisterClassEx-

Fensterklassen