Funzione GetClassInfoExA (winuser.h)

Articolo
08/27/2023

Recupera informazioni su una classe di finestra, incluso un handle per l'icona piccola associata alla classe di finestra. La funzione GetClassInfo non recupera un handle per l'icona di piccole dimensioni.

Sintassi

BOOL GetClassInfoExA(
  [in, optional] HINSTANCE     hInstance,
  [in]           LPCSTR        lpszClass,
  [out]          LPWNDCLASSEXA lpwcx
);

Parametri

[in, optional] hInstance

Tipo: HINSTANCE

Handle all'istanza dell'applicazione che ha creato la classe. Per recuperare informazioni sulle classi definite dal sistema ,ad esempio pulsanti o caselle di riepilogo, impostare questo parametro su NULL.

[in] lpszClass

Tipo: LPCTSTR

Nome della classe. Il nome deve essere quello di una classe preregistrata o di una classe registrata da una chiamata precedente alla funzione RegisterClass o RegisterClassEx . In alternativa, questo parametro può essere un atomo di classe creato da una chiamata precedente a RegisterClass o RegisterClassEx. L'atomo deve essere nella parola a basso ordine di lpszClass; la parola di ordine elevato deve essere zero.

[out] lpwcx

Tipo: LPWNDCLASSEX

Puntatore a una struttura WNDCLASSEX che riceve le informazioni sulla classe.

Valore restituito

Tipo: BOOL

Se la funzione trova una classe corrispondente e copia correttamente i dati, il valore restituito è diverso da zero.

Se la funzione non trova una classe corrispondente e copia correttamente i dati, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Gli atom di classe vengono creati usando la funzione RegisterClass o RegisterClassEx, non la funzione GlobalAddAtom.

Nota

L'intestazione winuser.h definisce GetClassInfoEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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 (introdotta in Windows 8)