Funzione EnumCalendarInfoExA (winnls.h)

Articolo
03/08/2023

Enumera le informazioni sul calendario per le impostazioni locali specificate dall'identificatore.

Nota Qualsiasi applicazione eseguita solo in Windows Vista e versioni successive deve usare EnumCalendarInfoExEx in preferenza per questa funzione.

Sintassi

BOOL EnumCalendarInfoExA(
  [in] CALINFO_ENUMPROCEXA lpCalInfoEnumProcEx,
  [in] LCID                Locale,
  [in] CALID               Calendar,
  [in] CALTYPE             CalType
);

Parametri

[in] lpCalInfoEnumProcEx

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

[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 o usare uno dei valori predefiniti seguenti.

Windows Vista e versioni successive: Sono supportati anche gli identificatori di impostazioni locali personalizzati seguenti.

[in] Calendar

Identificatore del 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.

Commenti

Questa funzione enumera le informazioni sul 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 sul calendario chiamando la funzione di callback definita dall'applicazione specificata. Passa la funzione di callback a un puntatore a un buffer contenente le informazioni sul calendario richieste. Questo processo continua finché EnumCalendarInfoEx non trova l'ultimo calendario applicabile o la funzione di callback restituisce FALSE.

Questa funzione può enumerare i dati dalle impostazioni locali personalizzate. Non è garantito che i dati siano gli stessi dal computer al computer o tra le esecuzioni di un'applicazione. Se l'applicazione deve rendere persistenti o trasmettere i dati, vedere Uso dei dati delle impostazioni locali persistenti.

Quando la versione ANSI di questa funzione viene usata con un identificatore delle impostazioni locali solo Unicode, la funzione può avere esito positivo perché il sistema operativo usa la tabella codici del sistema. Tuttavia, i caratteri non definiti nella tabella codici di sistema vengono visualizzati nella stringa come punto interrogativo (?).

Nota

L'intestazione winnls.h definisce EnumCalendarInfoEx 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll