Função DownlevelLCIDToLocaleName
Converte um identificador de localidade em um nome de localidade.
Observação
Essa função é usada apenas por aplicativos executados em sistemas operacionais pré-Windows Vista. Seu uso requer um pacote de download. Os aplicativos executados somente no Windows Vista e posterior devem chamar LCIDToLocaleName para recuperar um nome de localidade.
Sintaxe
int DownlevelLCIDToLocaleName(
_In_ LCID Locale,
_Out_ LPWSTR lpName,
_In_ int cchName,
_In_ DWORD dwFlags
);
Parâmetros
-
Localidade [in]
-
O identificador de localidade a ser convertido. Você pode usar a macro MAKELCID para criar um identificador de localidade. Essa função não dá suporte a localidades neutras ou aos seguintes valores de identificador de localidade específicos.
-
lpName [out]
-
Ponteiro para um buffer no qual essa função recupera o nome da localidade. A função recuperará NULL se cchName estiver definido como 0.
-
cchName [in]
-
Tamanho, em pontos de código UTF-16, do buffer de nome de localidade. O aplicativo define esse parâmetro como 0 para retornar o tamanho necessário do buffer de nome de localidade.
-
dwFlags [in]
-
Sinalizadores que especificam o tipo de nome a ser recuperado. O valor padrão é DOWNLEVEL_LOCALE_NAME.
Valor retornado
Retorna a contagem de pontos de código UTF-16 no nome da localidade, incluindo o caractere nulo de encerramento, se bem-sucedido. Se a função for bem-sucedida e o valor de cchName for 0, o valor retornado será o tamanho necessário, em caracteres (incluindo caracteres nulos), para o buffer de nome de localidade.
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_INSUFFICIENT_BUFFER. Um tamanho de buffer fornecido não era grande o suficiente ou foi definido incorretamente como NULL.
- ERROR_INVALID_FLAGS. O valor de dwFlags não é válido.
- 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 personalizadas.
O arquivo de cabeçalho necessário e a DLL fazem parte do download "APIs de mapeamento de dados de nível inferior do Microsoft NLS", que não está mais disponível no Centro de Download da Microsoft. Use APIs de globalização de ICU no Windows 10 da atualização de maio de 2019 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 de mapeamento de dados de nível inferior do Microsoft NLS no Windows XP com SP2 e versões posteriores ou Windows Vista |
| Cabeçalho |
|
| DLL |
|
Confira também