Funzione UnregisterClassA (winuser.h)

  • Articolo

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

Registerclass

RegisterClassEx

Classi finestra