Partilhar via


Função RtlIsValidLocaleName

Determina se uma localidade especificada pelo nome está instalada ou tem suporte no sistema operacional.

Observação

Essa função está disponível apenas para uso no Windows Vista. Ele pode estar alterado ou indisponível em versões subsequentes. Os aplicativos devem usar IsValidLocaleName.

 

Sintaxe

BOOL RtlIsValidLocaleName(
  _In_ LPCWSTR LocaleName,
  _In_ ULONG   Flags
);

Parâmetros

LocaleName [in]

Nome da localidade a ser validado. Esse parâmetro pode especificar o nome de uma localidade personalizada.

Sinalizadores [in]

Sinalizadores que indicam se as localidades neutras são consideradas válidas. Atualmente, o único sinalizador definido é LOCALE_ALLOW_NEUTRAL. O valor padrão é que eles não são.

Valor retornado

Retorna um valor diferente de zero se tiver êxito ou 0 de outra forma.

Comentários

Essa função é semelhante a IsValidLocaleName. A única diferença é que, se LOCALE_ALLOW_NEUTRAL estiver definido, RtlIsValidLocaleName retornará TRUE para um nome que corresponda a uma localidade neutra (como "en"), enquanto IsValidLocaleName retornará TRUE somente para uma localidade específica (como "en-US"). Localidades neutras são usadas como parte da estratégia de carregamento de recursos no Windows Vista e posteriores. Apenas uma pequena classe de aplicativos altamente especializados usa RtlIsValidLocaleName e define LOCALE_ALLOW_NEUTRAL, pois as localidades neutras são de uso muito limitado. Nenhuma das funções descritas em Chamar as funções "Nome da Localidade" aceita localidades neutras como entradas.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
Ntrtl.h
Biblioteca
Kernel32.lib
DLL
Kernel32.dll

Confira também

Suporte à linguagem nacional

Funções de suporte à linguagem nacional

IsValidLocaleName