Compartilhar via


Função DownlevelLocaleNameToLCID

Converte um nome de localidade em uma identificação de localidade que pode ser usada para obter informações do sistema operacional.

Observação

Essa função é usada apenas por aplicativos executados em sistemas operacionais anteriores ao Windows Vista. Seu uso requer um pacote de download. Os aplicativos executados apenas no Windows Vista e posteriores devem chamar LocaleNameToLCID para recuperar uma identificação de localidade.

 

Sintaxe

LCID DownlevelLocaleNameToLCID(
  _In_ LPWSTR lpName,
  _In_ DWORD  dwFlags
);

Parâmetros

lpName [in]

Ponteiro para uma cadeia de caracteres terminada em nulo que representa um nome de localidade.

dwFlags [in]

Sinalizadores especificando o tipo de nome. O padrão é DOWNLEVEL_LOCALE_NAME.

Valor retornado

Retornará a identificação de localidade que corresponde ao nome da localidade, se bem-sucedido.

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_INVALID_FLAGS. Os valores fornecidos para os sinalizadores não eram válidos.
  • 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 neutras. A função LocaleNameToLCID equivalente dá suporte a localidades personalizadas, mas somente para Windows Vista e posteriores.

 

O arquivo de cabeçalho e a DLL necessários fazem parte do download das "APIs Microsoft NLS Downlevel Data Mapping", que não está mais disponível no Centro de Download da Microsoft. Use as APIs de globalização do ICU na Atualização de maio de 2019 para o Windows 10 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 Microsoft NLS Downlevel Data Mapping no Windows XP com SP2 e posteriores ou no Windows Vista
Cabeçalho
Nlsdl.h
DLL
NlsMap.dll7

Confira também

Suporte ao idioma nacional

Funções de suporte ao idioma nacional

Mapeamento de dados da localidade

LocaleNameToLCID