Função EnumCalendarInfoA (winnls.h)

Artigo
08/27/2023

Enumera informações de calendário para uma localidade especificada.

Nota Para receber um identificador de calendário além das informações do calendário, o aplicativo deve usar a função EnumCalendarInfoEx . Outro motivo para preferir essa função é que a Microsoft está migrando para o uso de nomes de localidade em vez de identificadores de localidade para novas localidades, por motivos de interoperabilidade.

Nota Qualquer aplicativo que será executado somente no Windows Vista e posterior deve usar EnumCalendarInfoExEx em preferência para EnumCalendarInfo.

Sintaxe

BOOL EnumCalendarInfoA(
  [in] CALINFO_ENUMPROCA lpCalInfoEnumProc,
  [in] LCID              Locale,
  [in] CALID             Calendar,
  [in] CALTYPE           CalType
);

Parâmetros

[in] lpCalInfoEnumProc

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

[in] Locale

Identificador de localidade que especifica a localidade para a qual recuperar informações de calendário. Você pode usar a macro MAKELCID para criar um identificador de localidade ou usar um dos valores predefinidos a seguir.

[in] Calendar

Identificador de calendário que especifica o calendário para o qual as informações são solicitadas. Observe que esse identificador pode ser ENUM_ALL_CALENDARS, para enumerar todos os calendários associados à localidade.

[in] CalType

Tipo de informações de calendário. Para obter mais informações, consulte Informações de tipo de calendário. Somente um tipo de calendário pode ser especificado por chamada para essa função, exceto quando indicado.

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

Consulte Comentários para EnumCalendarInfoEx.

Observação

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