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 apontará 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 retornado
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.
Comentários
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.
Observação
O cabeçalho winver.h define VerLanguageName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winver.h (inclua Windows.h) |
| Biblioteca | Version.lib |
| DLL | Api-ms-win-core-localization-l1-2-1.dll |