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.

Requisiti

Vedi anche

Panoramica delle informazioni sulla versione