Funzione GetClassNameW (winuser.h)

Articolo
11/20/2024

Recupera il nome della classe a cui appartiene la finestra specificata.

Sintassi

int GetClassNameW(
  [in]  HWND   hWnd,
  [out] LPWSTR lpClassName,
  [in]  int    nMaxCount
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra e, indirettamente, la classe a cui appartiene la finestra.

[out] lpClassName

Tipo: LPTSTR

Stringa del nome della classe.

[in] nMaxCount

Tipo: int

Lunghezza del buffer lpClassName, espressa in caratteri. Il buffer deve essere sufficientemente grande da includere il carattere Null di terminazione; in caso contrario, la stringa del nome della classe viene troncata a nMaxCount-1 caratteri.

Valore restituito

Tipo: int

Se la funzione ha esito positivo, il valore restituito corrisponde al numero di caratteri copiati nel buffer, senza includere il carattere Null di terminazione.

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 GetClassName 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)