Condividi tramite


Funzione EnumCalendarInfoA (winnls.h)

Enumera le informazioni sul 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 cui si preferisce questa funzione è che Microsoft sta eseguendo la migrazione all'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 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

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

Vedere anche

Informazioni sul tipo di calendario

EnumCalendarInfoEx

EnumCalendarInfoExEx

EnumCalendarInfoProc

EnumDateFormats

MAKELCID

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale