Condividi tramite

Funzione VerLanguageNameA (winver.h)

  • Articolo

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

Dimensioni, 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.

Osservazioni

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 usata 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 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 winver.h (include Windows.h)
libreria Version.lib
dll Api-ms-win-core-localization-l1-2-1.dll

Vedere anche

panoramica delle informazioni sulla versione di