Função GetSystemDefaultUILanguage (winnls.h)

  • Artigo

Recupera o identificador de idioma para a linguagem de interface do usuário padrão do sistema do sistema operacional (também conhecido como a "linguagem de instalação" no Windows Vista e posterior). Para obter mais informações, consulte Gerenciamento de linguagem de interface do usuário.

Importante

O uso dessa função não é recomendado. Em vez disso, recomendamos usar as configurações de idioma do usuário pelos seguintes motivos.

  • "Instalar idioma" só é definido durante a OOBE (Experiência Pronta para Uso) e, em seguida, nunca é alterado. Se o idioma do sistema for alterado, essa função retornará um valor incorreto.
  • OS SKUs do WCOS sempre retornam um valor incorreto.
  • Essa função usa LANGIDs preteridos.

Sintaxe

LANGID GetSystemDefaultUILanguage();

Valor retornado

Retorna o identificador de idioma para a linguagem de interface do usuário padrão do sistema do sistema operacional. Para obter mais informações, consulte a seção Comentários.

Comentários

Essa função nunca retorna um identificador de idioma para um LIP (Language Interface Pack). Ele também nunca retorna um identificador de idioma correspondente ao identificador de localidade LOCALE_CUSTOM_UNSPECIFIED ou LOCALE_CUSTOM_UI_DEFAULT.

Observe que essa função não retorna necessariamente o identificador para o primeiro idioma na lista de idiomas de interface do usuário preferenciais do sistema. Portanto, o retorno pode não corresponder ao primeiro elemento recuperado por GetSystemPreferredUILanguages.

Assinatura do C#

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.UInt16 GetSystemDefaultUILanguage();

Requisitos

   
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

Confira também

EnumUILanguages, GetSystemPreferredUILanguages, GetUserDefaultUILanguage, Interface do Usuário Multilíngue, Funções de Interface do Usuário Multilíngue