Funzione EnumCalendarInfoA (winnls.h)

Articolo
11/20/2024

Enumera le informazioni del calendario per le impostazioni locali specificate.

Nota Per ricevere un identificatore di calendario oltre alle informazioni sul calendario, l'applicazione deve usare la funzione EnumCalendarInfoEx . Un altro motivo per preferire questa funzione è che Microsoft sta eseguendo la migrazione verso l'uso dei nomi delle impostazioni locali anziché degli identificatori delle impostazioni locali per le nuove impostazioni locali, per motivi di interoperabilità.

Nota Qualsiasi applicazione che verrà eseguita solo in Windows Vista e versioni successive deve usare EnumCalendarInfoExex in preferenza per EnumCalendarInfo.

Sintassi

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

Parametri

[in] lpCalInfoEnumProc

Puntatore a una funzione di callback definita dall'applicazione. Per altre informazioni, vedere EnumCalendarInfoProc.

[in] Locale

identificatore delle impostazioni locali che specifica le impostazioni locali per cui recuperare le informazioni del calendario. È possibile utilizzare la macro MAKELCID per creare un identificatore delle impostazioni locali o usare uno dei valori predefiniti seguenti.

[in] Calendar

identificatore calendario che specifica il calendario per cui vengono richieste le informazioni. Si noti che questo identificatore può essere ENUM_ALL_CALENDARS, per enumerare tutti i calendari associati alle impostazioni locali.

[in] CalType

Tipo di informazioni sul calendario. Per altre informazioni, vedere Informazioni sul tipo di calendario. È possibile specificare un solo tipo di calendario per ogni chiamata a questa funzione, tranne dove indicato.

Valore restituito

Restituisce un valore diverso da zero se ha esito positivo o 0 in caso contrario. Per ottenere informazioni estese sull'errore, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Osservazioni

Vedere la sezione Osservazioni per EnumCalendarInfoEx.

Nota

L'intestazione winnls.h definisce EnumCalendarInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winnls.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll