Funzione EnumCalendarInfoExEx (winnls.h)

Articolo
08/27/2023

Enumera le informazioni del calendario per le impostazioni locali specificate in base al nome.

Nota L'applicazione deve chiamare questa funzione in preferenza per EnumCalendarInfo o EnumCalendarInfoEx se progettata per l'esecuzione solo in Windows Vista e versioni successive.

Nota Questa funzione può enumerare i dati che cambiano tra le versioni, ad esempio a causa di impostazioni locali personalizzate. Se l'applicazione deve mantenere o trasmettere dati, vedere Uso di dati locali persistenti.

Sintassi

BOOL EnumCalendarInfoExEx(
  [in]           CALINFO_ENUMPROCEXEX pCalInfoEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           CALID                Calendar,
  [in, optional] LPCWSTR              lpReserved,
  [in]           CALTYPE              CalType,
  [in]           LPARAM               lParam
);

Parametri

[in] pCalInfoEnumProcExEx

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

[in, optional] lpLocaleName

Puntatore a un nome delle impostazioni locali o uno dei valori predefiniti seguenti.

[in] Calendar

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

[in, optional] lpReserved

Riservati; deve essere NULL.

[in] CalType

Tipo di informazioni sul calendario. Per altre informazioni, vedere Informazioni sul tipo di calendario. È possibile specificare un solo tipo di calendario per chiamata a questa funzione, ad eccezione del caso indicato.

[in] lParam

Parametro fornito dall'applicazione per passare alla funzione di callback. Questo valore è particolarmente utile per le applicazioni multi-thread.

Valore restituito

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

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

Commenti

Questa funzione enumera le informazioni del calendario per tutti i calendari applicabili per le impostazioni locali specificate o per un singolo calendario richiesto, a seconda del valore del parametro Calendar . La funzione enumera le informazioni del calendario chiamando la funzione di callback definita dall'applicazione specificata. Passa la funzione di callback a un puntatore a un buffer contenente le informazioni del calendario richieste, un identificatore del calendario e un parametro definito dall'applicazione utile per le applicazioni multi thread. Questo processo continua fino a quando EnumCalendarInfoExEx trova l'ultimo calendario applicabile o la funzione di callback restituisce FALSE.

A partire da Windows 8: se l'app passa tag di lingua a questa funzione dallo spazio dei nomi Windows.Globalization, deve prima convertire i tag chiamando ResolveLocaleName.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll