Função EnumLanguageGroupLocalesA (winnls.h)
Enumera as localidades em um grupo de idiomas especificado.
Sintaxe
BOOL EnumLanguageGroupLocalesA(
[in] LANGGROUPLOCALE_ENUMPROCA lpLangGroupLocaleEnumProc,
[in] LGRPID LanguageGroup,
[in] DWORD dwFlags,
[in] LONG_PTR lParam
);
Parâmetros
[in] lpLangGroupLocaleEnumProc
Ponteiro para uma função de retorno de chamada definida pelo aplicativo. Para obter mais informações, consulte EnumLanguageGroupLocalesProc.
[in] LanguageGroup
Identificador do grupo de idiomas para o qual enumerar localidades. Esse parâmetro pode ter um dos seguintes valores:
- LGRPID_ARABIC
- LGRPID_ARMENIAN
- LGRPID_BALTIC
- LGRPID_CENTRAL_EUROPE
- LGRPID_CYRILLIC
- LGRPID_GEORGIAN
- LGRPID_GREEK
- LGRPID_HEBREW
- LGRPID_INDIC
- LGRPID_JAPANESE
- LGRPID_KOREAN
- LGRPID_SIMPLIFIED_CHINESE
- LGRPID_TRADITIONAL_CHINESE
- LGRPID_THAI
- LGRPID_TURKIC
- LGRPID_TURKISH
- LGRPID_VIETNAMESE
- LGRPID_WESTERN_EUROPE
[in] dwFlags
Reservados; deve ser 0.
[in] lParam
Um valor definido pelo aplicativo a ser passado para a função de retorno de chamada. Esse valor pode ser usado para 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 retornado
Retornará um valor diferente de zero se tiver êxito ou 0 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 localidades no grupo de idiomas especificado passando identificadores de localidade, um de cada vez, para a função de retorno de chamada definida pelo aplicativo. Esse processo continua até que EnumLanguageGroupLocales encontre o último identificador de localidade ou a função de retorno de chamada retorne FALSE.
Observação
O cabeçalho winnls.h define EnumLanguageGroupLocales 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
| 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 |