Função DownlevelGetParentLocaleName

  • Artigo

Recupera o nome da localidade para o pai da localidade fornecida.

Observação

Essa função é usada apenas por aplicativos executados em sistemas operacionais pré-Windows Vista. Seu uso requer o pacote de download. Os aplicativos executados apenas no Windows Vista e posterior devem chamar GetLocaleInfo com o LCType definido como LOCALE_SPARENT.

 

Sintaxe

int DownlevelGetParentLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName
);

Parâmetros

Localidade [in]

Identificador de localidade da localidade. Você pode usar a macro MAKELCID para criar um identificador de localidade ou usar um dos seguintes valores predefinidos.

Windows Vista e posterior: também há suporte para os seguintes identificadores de localidade personalizados.

lpName [out]

Ponteiro para um buffer no qual a função recupera o nome da localidade pai ou um dos seguintes valores predefinidos. Esse parâmetro será definido como NULL se cchName for definido como 0.

cchName [in]

Tamanho do buffer indicado por lpName, em pontos de código UTF-16. Um valor de 0 para esse parâmetro faz com que a função ignore o buffer lpName e retorne o tamanho do buffer, em caracteres (caracteres nulos incluídos), necessário para conter o nome da localidade pai.

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.

Essa 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_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Comentários

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 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 de mapeamento de dados de nível inferior do Microsoft NLS no Windows XP com SP2 e posterior
Cabeçalho
Nlsdl.h
DLL
NlsMap.dll

Confira também

Suporte ao Idioma Nacional

Funções de Suporte ao Idioma Nacional

Mapeamento de Dados da Localidade

GetLocaleInfo