Função EnumSystemLocalesEx (winnls.h)

Artigo
03/05/2025

Enumera as localidades instaladas ou compatíveis com um sistema operacional.

Observação O aplicativo deve chamar essa função em preferência para EnumSystemLocales se projetado para ser executado somente no Windows Vista e posterior.

Sintaxe

BOOL EnumSystemLocalesEx(
  [in]           LOCALE_ENUMPROCEX lpLocaleEnumProcEx,
  [in]           DWORD             dwFlags,
  [in]           LPARAM            lParam,
  [in, optional] LPVOID            lpReserved
);

Parâmetros

[in] lpLocaleEnumProcEx

Ponteiro para uma função de retorno de chamada definida pelo aplicativo. A função EnumSystemLocalesEx enumera localidades fazendo chamadas repetidas para essa função de retorno de chamada. Para obter mais informações, consulte EnumLocalesProcEx.

[in] dwFlags

Sinalizadores que identificam as localidades a serem enumeradas. Os sinalizadores podem ser usados com ou combinação usando um OR binário. Se o aplicativo especificar 0 para esse parâmetro, a função se comportará como para LOCALE_ALL.

[in] lParam

Um parâmetro fornecido pelo aplicativo a ser passado para a função de retorno de chamada. Isso é especialmente útil para aplicativos com vários threads.

[in, optional] lpReserved

Reservado; deve ser NULL.

Valor de retorno

Retorna um valor diferente de zero se tiver êxito ou 0 de outra forma. 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 localidades passando nomes de localidade, um de cada vez, para a função de retorno de chamada definida pelo aplicativo especificada por lpLocaleEnumProcEx. A enumeração continua até que todos os nomes instalados ou com suporte tenham sido passados para a função de retorno de chamada ou a função de retorno de chamada retorne FALSE.

As opções para o parâmetro dwFlags são diferentes daquelas para EnumSystemLocales, que devem distinguir entre localidades instaladas e com suporte.

Se dwFlags especificar LOCALE_ALTERNATE_SORTS, a função de retorno de chamada será chamada para cada localidade que representa uma ordem de classificação alternativa. Por exemplo, espanhol (Espanha) usa como padrão a ordem de classificação internacional, mas a ordem de classificação tradicional está disponível para uma classificação alternativa. Alemão (Alemanha) usa como padrão a ordem de classificação de dicionário, mas há uma ordem de classificação de lista telefônica alternativa disponível.

Exemplos

Um exemplo mostrando o uso dessa função pode ser encontrado em NLS: exemplo de APIs baseadas em nome.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	winnls.h (inclua Windows.h)
biblioteca	Kernel32.lib
de DLL	Kernel32.dll

Consulte também

EnumLocalesProcEx

EnumSystemLocales

de Suporte à Linguagem Nacional

funções de suporte à linguagem nacional

Compartilhar via