Função EnumSystemLocalesEx (winnls.h)

  • Artigo

Enumera as localidades instaladas ou com suporte de um sistema operacional.

Nota 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 combinados 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 multi-threaded.

[in, optional] lpReserved

Reservados; deve ser NULL.

Retornar valor

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 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 dwFlagsespecificar 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. O alemão (Alemanha) usa como padrão a ordem de classificação do dicionário, mas há uma ordem de classificação de catálogo telefônico 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
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winnls.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

EnumLocalesProcEx

EnumSystemLocales

Suporte a idiomas nacionais

Funções de suporte à linguagem nacional