Função VerLanguageNameW (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 VerLanguageNameW(
  [in]  DWORD  wLang,
  [out] LPWSTR 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 ("Idioma Neutro").

[out] szLang

Tipo: LPTSTR

A linguagem especificada pelo parâmetro wLang .

[in] cchLang

Tipo: DWORD

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

Retornar valor

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 idioma 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 linguagem 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

Requisito	Valor
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 (incluir Windows.h)
Biblioteca	Version.lib
DLL	Api-ms-win-core-localization-l1-2-1.dll

Confira também

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