Função ResolveLocaleName (winnls.h)

  • Artigo

Localiza uma possível correspondência de nome de localidade para o nome fornecido.

Sintaxe

int ResolveLocaleName(
  [in, optional]  LPCWSTR lpNameToResolve,
  [out, optional] LPWSTR  lpLocaleName,
  [in]            int     cchLocaleName
);

Parâmetros

[in, optional] lpNameToResolve

Ponteiro para um nome para resolve, por exemplo, "en-XA" para inglês (uso privado).

[out, optional] lpLocaleName

Ponteiro para um buffer no qual essa função recupera o nome da localidade que é a correspondência para o nome de entrada. Por exemplo, a correspondência para o nome "en-XA" é "en-US" para inglês (Estados Unidos).

Nota Se a função falhar, não será garantido que o estado do buffer de saída seja preciso. Nesse caso, o aplicativo deve marcar o valor retornado e o erro status definidos pela função para determinar o curso de ação correto.
 

[in] cchLocaleName

Tamanho, em caracteres, do buffer indicado por lpLocaleName. O comprimento máximo possível de um nome de localidade, incluindo um caractere nulo de terminação, é o valor de LOCALE_NAME_MAX_LENGTH. Esse é o tamanho recomendado para fornecer nesse parâmetro.

Valor retornado

Retorna o tamanho do buffer que contém o nome da localidade, incluindo o caractere nulo de terminação, 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_INSUFFICIENT_BUFFER. Um tamanho de buffer fornecido não era grande o suficiente ou foi definido incorretamente como NULL.

Comentários

O nome da localidade recuperada indica uma localidade específica, incluindo idioma e país/região, mesmo que a linguagem de entrada seja neutra. Por exemplo, uma entrada de "en" para inglês (Estados Unidos) faz com que a função recupere "en-US".

Essa função pode recuperar dados de localidades personalizadas. Não há garantia de que os dados sejam iguais de computador para computador ou entre execuções de um aplicativo, nem o retorno de uma localidade válida garante que ele será válido em outro computador. Se o aplicativo precisar persistir ou transmitir dados, consulte Usando dados de localidade persistente.

A partir do Windows 8: As marcas de linguagem obtidas do namespace Windows.Globalization devem ser convertidas por ResolveLocaleName antes que possam ser usadas com qualquer função de Suporte à Linguagem Nacional.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winnls.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Suporte à linguagem nacional

Funções de suporte à linguagem nacional

Windows.Globalization