Compartilhar via


Função EnumSystemLanguageGroupsA (winnls.h)

Enumera os grupos de idiomas instalados ou com suporte de um sistema operacional.

Nota Para localidades personalizadas, seu aplicativo deve chamar EnumSystemLocalesEx em vez de EnumSystemLanguageGroups.

 

Sintaxe

BOOL EnumSystemLanguageGroupsA(
  [in] LANGUAGEGROUP_ENUMPROCA lpLanguageGroupEnumProc,
  [in] DWORD                   dwFlags,
  [in] LONG_PTR                lParam
);

Parâmetros

[in] lpLanguageGroupEnumProc

Ponteiro para uma função de retorno de chamada definida pelo aplicativo. Para obter mais informações, consulte EnumLanguageGroupsProc.

[in] dwFlags

Sinalizadores que especificam os identificadores do grupo de idiomas a serem enumerados. Esse parâmetro pode ter um dos valores a seguir.

Valor Significado
LGRPID_INSTALLED
Enumerar somente identificadores de grupo de idiomas instalados.
LGRPID_SUPPORTED
Enumerar todos os identificadores de grupo de idiomas com suporte.

[in] lParam

Valor definido pelo aplicativo a ser passado para a função de retorno de chamada. Esse parâmetro pode ser usado na verificação de erros. Ele também pode ser usado para garantir a segurança do thread na função de retorno de chamada.

Retornar valor

Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:

  • ERROR_BADDB. A função não pôde acessar os dados. Normalmente, essa situação não deve ocorrer e geralmente indica uma instalação incorreta, um problema de disco ou similar.
  • ERROR_INVALID_FLAGS. Os valores fornecidos para sinalizadores não eram válidos.
  • ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Comentários

Essa função enumera grupos de idiomas passando identificadores de grupo de idiomas, um de cada vez, para a função de retorno de chamada definida pelo aplicativo especificada. Esse processo continua até que o último identificador do grupo de idiomas seja encontrado ou a função de retorno de chamada retorne FALSE.

Observação

O cabeçalho winnls.h define EnumSystemLanguageGroups como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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

Confira também

Enumlanguagegrouplocales

Enumlanguagegroupsproc

IsValidLanguageGroup

Suporte a idiomas nacionais

Funções de suporte à linguagem nacional