Função VerLanguageNameA (winver.h)

Recupera uma cadeia de caracteres de descrição para o idioma associado a um identificador de idioma binário da Microsoft especificado.

Sintaxe

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

Parâmetros

[in] wLang

Tipo: DWORD

O identificador de linguagem binária. Para obter uma lista completa dos identificadores de idioma, consulte Identificadores de Idioma.

Por exemplo, a cadeia de caracteres de descrição associada ao identificador de idioma 0x040A é "Espanhol (Classificação Tradicional)". Se o identificador for desconhecido, o parâmetro szLang aponta para uma cadeia de caracteres padrão ("Language Neutral").

[out] szLang

Tipo: LPTSTR

O idioma especificado pelo parâmetro wLang.

[in] cchLang

Tipo: DWORD

O tamanho, em caracteres, do buffer apontado por szLang.

Valor de retorno

Tipo: DWORD

O valor retornado é o tamanho, em caracteres, da cadeia de caracteres retornada no buffer. Esse valor não inclui o caractere nulo de terminação. Se a cadeia de caracteres de descrição for menor ou igual ao buffer, toda a cadeia de caracteres de descrição estará no buffer. Se a cadeia de caracteres de descrição for maior que o buffer, a cadeia de caracteres de descrição será truncada até o comprimento do buffer.

Se ocorrer um erro, o valor retornado será zero. Identificadores de linguagem desconhecidos não produzem erros.

Observações

Essa função funciona em imagens de arquivo de 16, 32 e 64 bits.

Normalmente, um programa de instalação usa essa função para traduzir um identificador de idioma retornado pela função VerQueryValue. A cadeia de caracteres de texto pode ser usada em uma caixa de diálogo que pergunta ao usuário como proceder em caso de conflito de idioma.

Requisitos

Consulte também

Visão geral das informações de versão