Funzione UnregisterClassA (winuser.h)
Annulla la registrazione di una classe 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 funzione RegisterClass o 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 informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Prima di chiamare questa funzione, un'applicazione deve eliminare tutte le finestre create con la classe specificata.
Tutte le classi finestra registrate da un'applicazione vengono annullate al termine della registrazione.
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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| 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) |
Vedi anche
Informazioni concettuali
Riferimento