Função EnumSystemLanguageGroupsA (winnls.h)
Enumera os grupos de idiomas instalados ou com suporte de um sistema operacional.
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 |
---|---|
|
Enumerar somente identificadores de grupo de idiomas instalados. |
|
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 |