Função DownlevelLCIDToLocaleName

  • Artigo

Converte um identificador de localidade em um nome de localidade.

Observação

Essa função é usada apenas por aplicativos executados em sistemas operacionais pré-Windows Vista. Seu uso requer um pacote de download. Os aplicativos executados somente no Windows Vista e posterior devem chamar LCIDToLocaleName para recuperar um nome de localidade.

 

Sintaxe

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

Parâmetros

Localidade [in]

O identificador de localidade a ser convertido. Você pode usar a macro MAKELCID para criar um identificador de localidade. Essa função não dá suporte a localidades neutras ou aos seguintes valores de identificador de localidade específicos.

lpName [out]

Ponteiro para um buffer no qual essa função recupera o nome da localidade. A função recuperará NULL se cchName estiver definido como 0.

cchName [in]

Tamanho, em pontos de código UTF-16, do buffer de nome de localidade. O aplicativo define esse parâmetro como 0 para retornar o tamanho necessário do buffer de nome de localidade.

dwFlags [in]

Sinalizadores que especificam o tipo de nome a ser recuperado. O valor padrão é DOWNLEVEL_LOCALE_NAME.

Valor retornado

Retorna a contagem de pontos de código UTF-16 no nome da localidade, incluindo o caractere nulo de encerramento, se bem-sucedido. Se a função for bem-sucedida e o valor de cchName for 0, o valor retornado será o tamanho necessário, em caracteres (incluindo caracteres nulos), para o buffer de nome de localidade.

A função retornará 0 se não for bem-sucedida. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:

  • ERROR_INSUFFICIENT_BUFFER. Um tamanho de buffer fornecido não era grande o suficiente ou foi definido incorretamente como NULL.
  • ERROR_INVALID_FLAGS. O valor de dwFlags não é válido.
  • ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Comentários

Observação

Essa função não dá suporte a localidades personalizadas.

 

O arquivo de cabeçalho necessário e a DLL fazem parte do download "APIs de mapeamento de dados de nível inferior do Microsoft NLS", que não está mais disponível no Centro de Download da Microsoft. Use APIs de globalização de ICU no Windows 10 da atualização de maio de 2019 e versões posteriores.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
Redistribuível
 APIs de mapeamento de dados de nível inferior do Microsoft NLS no Windows XP com SP2 e versões posteriores ou Windows Vista
Cabeçalho
Nlsdl.h
DLL
NlsMap.dll

Confira também

Suporte ao idioma nacional

Funções de suporte ao idioma nacional

Mapeamento de dados de localidade

LCIDToLocaleName