Compartilhar via

Função IsValidLocaleName (winnls.h)

  • Artigo

Determina se o nome de localidade especificado é válido para uma localidade instalada ou com suporte no sistema operacional.

Nota Um aplicativo em execução somente no Windows Vista e posterior deve chamar essa função em preferência para IsValidLocale para determinar a validade de uma localidade complementar.

 

Sintaxe

BOOL IsValidLocaleName(
  [in] LPCWSTR lpLocaleName
);

Parâmetros

[in] lpLocaleName

Ponteiro para o nome da localidade a ser validado.

Valor retornado

Retornará um valor diferente de zero se o nome da localidade for válido ou retornará 0 para um nome inválido.

Comentários

No Windows Vista e posterior, todas as localidades com suporte devem ser instaladas em todos os sistemas operacionais.

Essa função pode manipular o nome de uma localidade personalizada. Não há garantia de que os dados sejam iguais de computador para computador ou entre execuções de um aplicativo. Se o aplicativo precisar persistir ou transmitir dados, consulte Usando dados de localidade persistente.

A partir do Windows 8: Se seu aplicativo passar marcas de idioma para essa função do namespace Windows.Globalization , ele deverá primeiro converter as marcas chamando ResolveLocaleName.

Exemplos

Um exemplo mostrando o uso dessa função pode ser encontrado em NLS: Exemplo de APIs baseadas em nome.

Requisitos

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [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

Getlocaleinfoex

IsValidLocale

Suporte a idiomas nacionais

Funções de suporte à linguagem nacional