Função ConvertDefaultLocale (winnls.h)

Artigo
03/13/2024

Converte um valor de localidade padrão em um identificador de localidade real.

Nota Essa função só é fornecida para converter identificadores de localidade parciais. Seus aplicativos devem usar nomes de localidade em vez de identificadores. A função LCIDToLocaleName pode ser usada para converter um identificador de localidade em um nome de localidade válido. Seu aplicativo também pode usar GetUserDefaultLocaleName para recuperar o nome de localidade do usuário atual; GetSystemDefaultLocaleName para recuperar o nome da localidade do sistema atual; e GetLocaleInfoEx com LOCALE_SNAME para recuperar o nome da localidade para qualquer localidade de entrada, incluindo as constantes padrão.

Sintaxe

LCID ConvertDefaultLocale(
  [in] LCID Locale
);

Parâmetros

[in] Locale

Valor do identificador de localidade padrão a ser convertido. Você pode usar a macro MAKELCID para criar um identificador de localidade ou usar um dos seguintes valores predefinidos.

Windows Vista e posterior: Também há suporte para os seguintes identificadores de localidade personalizados.

Retornar valor

Retorna o identificador de localidade apropriado se for bem-sucedido.

Essa função retornará o valor do parâmetro Locale se ele não for bem-sucedido. A função falha quando o valor local não é um dos valores padrão listados acima.

Comentários

Uma chamada para ConvertDefaultLocale especificando LOCALE_SYSTEM_DEFAULT é equivalente a uma chamada para GetSystemDefaultLCID. Uma chamada para ConvertDefaultLocale especificando LOCALE_USER_DEFAULT é equivalente a uma chamada para GetUserDefaultLCID.

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