Função EnumSystemLocalesA (winnls.h)

Artigo
11/20/2024

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

Observação Por motivos de interoperabilidade, o aplicativo deve preferir a função EnumSystemLocalesEx para EnumSystemLocales porque a Microsoft está migrando para o uso de nomes de localidade em vez de identificadores de localidade para novas localidades. Qualquer aplicativo que será executado somente no Windows Vista e posterior deve usar EnumSystemLocalesEx.

Sintaxe

BOOL EnumSystemLocalesA(
  [in] LOCALE_ENUMPROCA lpLocaleEnumProc,
  [in] DWORD            dwFlags
);

Parâmetros

[in] lpLocaleEnumProc

Ponteiro para uma função de retorno de chamada definida pelo aplicativo. Para obter mais informações, consulte EnumLocalesProc.

[in] dwFlags

Sinalizadores que especificam os identificadores de localidade a serem enumerados. 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 LCID_SUPPORTED.

Valor	Significado
LCID_INSTALLED	Enumerar somente identificadores de localidade instalados. Esse valor não pode ser usado com LCID_SUPPORTED.
LCID_SUPPORTED	Enumera todos os identificadores de localidade com suporte. Esse valor não pode ser usado com LCID_INSTALLED.
LCID_ALTERNATE_SORTS	Enumera apenas os identificadores de localidade de classificação alternativos. Se esse valor for usado com LCID_INSTALLED ou LCID_SUPPORTED, as localidades instaladas ou com suporte serão recuperadas, bem como os identificadores de localidade de classificação alternativos.

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

A função enumera localidades passando identificadores de localidade, um de cada vez, para a função de retorno de chamada definida pelo aplicativo especificada. Isso continuará até que todos os identificadores de localidade 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.

Nota

O cabeçalho winnls.h define EnumSystemLocales 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

EnumLocalesProc

EnumSystemLocalesEx

de Suporte à Linguagem Nacional

funções de suporte à linguagem nacional

Compartilhar via