Função IsValidLocale (winnls.h)

  • Artigo

[IsValidLocale está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use IsValidLocaleName para determinar a validade de uma localidade complementar.]

Determina se a localidade especificada está instalada ou tem suporte no sistema operacional. Para obter mais informações, consulte Localidades e idiomas.

Sintaxe

BOOL IsValidLocale(
  [in] LCID  Locale,
  [in] DWORD dwFlags
);

Parâmetros

[in] Locale

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

[in] dwFlags

Sinalizador que especifica o teste de validade a ser aplicado ao identificador de localidade. Esse parâmetro pode ter um dos valores a seguir.

Valor Significado
LCID_INSTALLED
 Determine se o identificador de localidade tem suporte e está instalado.
LCID_SUPPORTED
 Determine se há suporte para o identificador de localidade.
0x39
 Não use. Em vez disso, use LCID_INSTALLED.

Windows Server 2008, Windows Vista, Windows Server 2003, Windows XP e Windows 2000: Definir dwFlags como 0x39 é um caso especial que pode se comportar como LCID_INSTALLED para algumas localidades em algumas versões do Windows.

Retornar valor

Retorna um valor diferente de zero se o identificador de localidade for aprovado no teste de validade especificado. A função retornará 0 se não for bem-sucedida.

Comentários

Se o sinalizador LCID_INSTALLED for especificado e essa função retornar um valor diferente de zero, o identificador de localidade terá suporte e será instalado no sistema operacional. Ter um identificador instalado implica que o nível completo de suporte ao idioma está disponível para a localidade indicada. O suporte completo inclui tabelas de tradução de página de código, layouts de teclado, fontes e classificação e dados de localidade.

Se LCID_SUPPORTED for especificado e essa função retornar 0, o identificador de localidade terá suporte na versão, mas não necessariamente instalado no sistema operacional.

Essa função pode manipular 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. Se o aplicativo precisar persistir ou transmitir dados, consulte Usando dados de localidade persistente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winnls.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Getlocaleinfo

IsValidLocaleName

Suporte a idiomas nacionais

Funções de suporte à linguagem nacional