Função EnumCalendarInfoA (winnls.h)

Artigo
11/20/2024

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

Observação 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.

Observação 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 seguintes valores predefinidos.

[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 observado.

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

Consulte Comentários para EnumCalendarInfoEx.

Nota

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

de informações de tipo de calendário

EnumCalendarInfoEx

EnumCalendarInfoExEx

EnumCalendarInfoProc

EnumDateFormats

MAKELCID

de Suporte à Linguagem Nacional

funções de suporte à linguagem nacional

Compartilhar via