Funzione GetClassInfoA (winuser.h)

Articolo
11/20/2024

Recupera informazioni su una classe window.

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

Sintassi

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

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

Tipo: LPCTSTR

Nome della classe. Il nome deve essere quello di una classe preregiscritta o di una classe registrata da una chiamata precedente alla RegisterClass o funzione RegisterClassEx.

In alternativa, questo parametro può essere un atom. In tal caso, deve essere un atomo di classe creato da una chiamata precedente a RegisterClass o RegisterClassEx. L'atomo deve essere nella parola in ordine basso 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
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)