Funzione VerLanguageNameA (winver.h)

Recupera una stringa di descrizione per la lingua associata a un identificatore di lingua Microsoft binario specificato.

Sintassi

DWORD VerLanguageNameA(
  [in]  DWORD wLang,
  [out] LPSTR szLang,
  [in]  DWORD cchLang
);

Parametri

[in] wLang

Tipo: DWORD

Identificatore di lingua binaria. Per un elenco completo degli identificatori di lingua, vedere Identificatori di lingua.

Ad esempio, la stringa di descrizione associata all'identificatore di lingua 0x040A è "Spagnolo (Ordinamento tradizionale)". Se l'identificatore è sconosciuto, il parametro szLang punta a una stringa predefinita ("Language Neutral").

[out] szLang

Tipo: LPTSTR

Lingua specificata dal parametro wLang .

[in] cchLang

Tipo: DWORD

Dimensione, in caratteri, del buffer a cui punta szLang.

Valore restituito

Tipo: DWORD

Il valore restituito è la dimensione, in caratteri, della stringa restituita nel buffer. Questo valore non include il carattere Null di terminazione. Se la stringa di descrizione è minore o uguale al buffer, l'intera stringa di descrizione si trova nel buffer. Se la stringa di descrizione è maggiore del buffer, la stringa di descrizione viene troncata alla lunghezza del buffer.

Se si verifica un errore, il valore restituito è zero. Gli identificatori di lingua sconosciuti non generano errori.

Commenti

Questa funzione funziona su immagini di file a 16, 32 e 64 bit.

In genere, un programma di installazione usa questa funzione per tradurre un identificatore di lingua restituito dalla funzione VerQueryValue . La stringa di testo può essere utilizzata in una finestra di dialogo che chiede all'utente come procedere in caso di conflitto di lingua.

Nota

L'intestazione winver.h definisce VerLanguageName 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

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winver.h (include Windows.h)
Libreria Version.lib
DLL Api-ms-win-core-localization-l1-2-1.dll

Vedi anche

Panoramica delle informazioni sulla versione