Função IsValidLocaleName (winnls.h)

Artigo
08/27/2023

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