Funzione UnregisterClassA (winuser.h)

Articolo
11/20/2024

Annulla la registrazione di una classe di finestra, liberando la memoria necessaria per la classe .

Sintassi

BOOL UnregisterClassA(
  [in]           LPCSTR    lpClassName,
  [in, optional] HINSTANCE hInstance
);

Parametri

[in] lpClassName

Tipo: LPCTSTR

Stringa con terminazione Null o atom di classe. Se lpClassName è una stringa, specifica il nome della classe della finestra. Questo nome di classe deve essere stato registrato da una chiamata precedente alla funzione RegisterClass o RegisterClassEx. Le classi di sistema, ad esempio i controlli della finestra di dialogo, non possono essere annullate. Se questo parametro è un atomo, deve essere un atom di classe creato da una chiamata precedente alla RegisterClass o funzione RegisterClassEx. L'atomo deve essere nella parola in ordine basso di lpClassName; la parola di ordine elevato deve essere zero.

[in, optional] hInstance

Tipo: HINSTANCE

Handle per l'istanza del modulo che ha creato la classe .

Valore restituito

Tipo: bool

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la classe non è stata trovata o se esiste ancora una finestra creata con la classe , il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Prima di chiamare questa funzione, un'applicazione deve eliminare tutte le finestre create con la classe specificata.

Tutte le classi di finestre registrate da un'applicazione vengono annullate quando termina.

Gli atomi di classe sono atomi speciali restituiti solo da RegisterClass e RegisterClassEx.

Nessuna classe finestra registrata da una DLL viene annullata quando il .dll viene scaricato.

Nota

L'intestazione winuser.h definisce UnregisterClass come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll
set di API	ext-ms-win-ntuser-windowclass-l1-1-0 (introdotto in Windows 8)

Vedere anche

concettuale

riferimento

RegisterClass

RegisterClassEx

classi finestra

Condividi tramite