Funzione GetClassInfoExW (winuser.h)

Articolo
08/27/2023

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

Sintassi

BOOL GetClassInfoExW(
  [in, optional] HINSTANCE     hInstance,
  [in]           LPCWSTR       lpszClass,
  [out]          LPWNDCLASSEXW lpwcx
);

Parametri

[in, optional] hInstance

Tipo: HINSTANCE

Handle per l'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 preregiscritta 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 in ordine basso 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 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)