Função EnumSystemLanguageGroupsA (winnls.h)

Artigo
11/20/2024

Enumera os grupos de idiomas instalados ou compatíveis com um sistema operacional.

Observação 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.

Valor de retorno

Retorna verdadeiro 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. Essa situação normalmente não deve ocorrer e normalmente 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.

Observações

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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winnls.h (inclua Windows.h)
biblioteca	Kernel32.lib
de DLL	Kernel32.dll

Consulte também

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

de Suporte à Linguagem Nacional

funções de suporte à linguagem nacional

Compartilhar via