Funzione GetClassInfoA (winuser.h)

Articolo
03/09/2024

Recupera informazioni su una classe di finestra.

Nota La funzione GetClassInfo è stata sostituita dalla funzione GetClassInfoEx . È comunque possibile usare GetClassInfo, se non sono necessarie informazioni sull'icona di classe piccola.

Sintassi

BOOL GetClassInfoA(
  [in, optional] HINSTANCE   hInstance,
  [in]           LPCSTR      lpClassName,
  [out]          LPWNDCLASSA lpWndClass
);

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] lpClassName

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. In tal caso, deve essere un atomo di classe creato da una chiamata precedente a RegisterClass o RegisterClassEx. L'atomo deve essere nella parola a basso ordine di lpClassName; la parola di ordine elevato deve essere zero.

[out] lpWndClass

Tipo: LPWNDCLASS

Puntatore a una struttura WNDCLASS 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 ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Nota

L'intestazione winuser.h definisce GetClassInfo 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)