Função DownlevelLocaleNameToLCID
Converte um nome de localidade em uma identificação de localidade que pode ser usada para obter informações do sistema operacional.
Observação
Essa função é usada apenas por aplicativos executados em sistemas operacionais anteriores ao Windows Vista. Seu uso requer um pacote de download. Os aplicativos executados apenas no Windows Vista e posteriores devem chamar LocaleNameToLCID para recuperar uma identificação de localidade.
Sintaxe
LCID DownlevelLocaleNameToLCID(
_In_ LPWSTR lpName,
_In_ DWORD dwFlags
);
Parâmetros
-
lpName [in]
-
Ponteiro para uma cadeia de caracteres terminada em nulo que representa um nome de localidade.
-
dwFlags [in]
-
Sinalizadores especificando o tipo de nome. O padrão é DOWNLEVEL_LOCALE_NAME.
Valor retornado
Retornará a identificação de localidade que corresponde ao nome da localidade, se bem-sucedido.
A função retornará 0 se não for bem-sucedida. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:
- ERROR_INVALID_FLAGS. Os valores fornecidos para os sinalizadores não eram válidos.
- ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.
Comentários
Observação
Essa função não dá suporte a localidades neutras. A função LocaleNameToLCID equivalente dá suporte a localidades personalizadas, mas somente para Windows Vista e posteriores.
O arquivo de cabeçalho e a DLL necessários fazem parte do download das "APIs Microsoft NLS Downlevel Data Mapping", que não está mais disponível no Centro de Download da Microsoft. Use as APIs de globalização do ICU na Atualização de maio de 2019 para o Windows 10 e versões posteriores.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Redistribuível |
APIs Microsoft NLS Downlevel Data Mapping no Windows XP com SP2 e posteriores ou no Windows Vista |
| Cabeçalho |
|
| DLL |
|
Confira também