Nomes de localidade
Um nome de de localidade é baseado nas convenções de marcação de idioma do IETF BCP 47 (Windows Vista e posterior) e é representado por LOCALE_SNAME. Geralmente, o padrão <language>-<REGION> é usado. Aqui, idioma é um código de idioma ISO 639 minúsculo. Os códigos da ISO 639-1 são usados quando disponíveis. Caso contrário, são utilizados códigos da norma ISO 639-2/T. REGION especifica um identificador de país/região ISO 3166-1 maiúsculo. Por exemplo, o nome da localidade para Inglês (Estados Unidos) é "en-US" e o nome da localidade para Divehi (Maldivas) é "dv-MV".
Observação
A constante LOCALE_NAME_MAX_LENGTH fornece o comprimento máximo de um nome de localidade. Inclui espaço para um caractere nulo de terminação.
Se a localidade for uma localidade neutra (sem região), o valor LOCALE_SNAME seguirá o padrão <language>. Se for uma localidade neutra para a qual o script é significativo, o padrão é <language>-<Script>.
Se uma localidade precisar ser distinguida de outra localidade para o mesmo idioma e região usando um script diferente, o valor LOCALE_SNAME seguirá o padrão <language>-<Script>-<REGION>, onde Script é uma inicial maiúscula código de script ISO 15924. Por exemplo, o valor LOCALE_SNAME para a localidade específica Uzbeque (latim, Uzbequistão) é "uz-Latn-UZ". O componente script não está incluído nos casos em que uma linguagem é normalmente escrita em apenas um script.
As ordens de classificação para localidades são designadas usando identificadores de ordem de classificação , por exemplo, SORT_DEFAULT. Para distinguir duas ou mais ordens de classificação para o mesmo idioma e região, o nome da localidade segue o padrão <language>-<REGION>\_<sort order>. Se você precisar distinguir o script e a ordem de classificação, o nome seguirá o padrão <language>-<Script>-<REGION>\_<sort order>. A ordem de classificação padrão nunca é especificada explicitamente, apenas a ordem de classificação alternativa. Por exemplo, húngaro (Hungria) com SORT_DEFAULT ou o equivalente numérico SORT_HUNGARIAN_DEFAULT é designado "hu-HU". Húngaro (Hungria) com ordem de classificação SORT_HUNGARIAN_TECHNICAL é designado "hu-HU_technl".
Para uma de localidade de substituição, o nome da localidade deve ser o mesmo que o nome da localidade que está sendo substituída. Para uma localidade suplementar, o nome da localidade deve seguir o padrão de <language>-<REGION>-x-<custom> ou <language>-<Script>-<REGION>-x-<custom>, onde <custom> é uma cadeia alfanumérica específica para a localidade suplementar. Por exemplo, uma localidade suplementar específica para uma empresa chamada Fabricam pode ser chamada de "en-US-x-fabricam".
Um aplicativo pode recuperar os nomes de localidade atuais usando o GetSystemDefaultLocaleName e funções de GetUserDefaultLocaleName. Embora cada thread possa recuperar e definir seu próprio identificador de localidade com GetThreadLocale e defini-lo com SetThreadLocale, não há funções análogas para obter e definir a localidade pelo nome.