Compartilhar via


Função EnumLanguageGroupLocalesW (winnls.h)

Enumera as localidades em um grupo de idiomas especificado.

Observação Para localidades personalizadas, seu aplicativo deve chamar EnumSystemLocalesEx em preferência para EnumLanguageGroupLocales.

 

Sintaxe

BOOL EnumLanguageGroupLocalesW(
  [in] LANGGROUPLOCALE_ENUMPROCW 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

Reservado; 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 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 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é EnumLanguageGroupLocales localizar o último identificador de localidade ou a função de retorno de chamada retornar false.

Nota

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 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

EnumLanguageGroupLocalesProc

EnumSystemLanguageGroups

EnumSystemLocalesEx

IsValidLanguageGroup

de Suporte à Linguagem Nacional

funções de suporte à linguagem nacional