Funzione GetCalendarInfoEx (winnls.h)

  • Articolo

Recupera informazioni su un calendario per le impostazioni locali specificate in base al nome.

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

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

Sintassi

int GetCalendarInfoEx(
  [in, optional]  LPCWSTR lpLocaleName,
  [in]            CALID   Calendar,
  [in, optional]  LPCWSTR lpReserved,
  [in]            CALTYPE CalType,
  [out, optional] LPWSTR  lpCalData,
  [in]            int     cchData,
  [out, optional] LPDWORD lpValue
);

Parametri

[in, optional] lpLocaleName

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

[in] Calendar

Identificatore del calendario.

[in, optional] lpReserved

Riservati; deve essere NULL.

[in] CalType

Tipo di informazioni da recuperare. Per altre informazioni, vedere Informazioni sul tipo di calendario.

NotaGetCalendarInfoEx restituisce una sola stringa se questo parametro specifica CAL_IYEAROFFSETRANGE o CAL_SERASTRING. In entrambi i casi viene restituita l'era corrente.
 
Per CAL_NOUSEROVERRIDE, la funzione ignora qualsiasi valore impostato da SetCalendarInfo e usa le impostazioni del database per le impostazioni locali predefinite del sistema corrente. Questo tipo è rilevante solo nella combinazione CAL_NOUSEROVERRIDE | CAL_ITWODIGITYEARMAX. CAL_ITWODIGITYEARMAX è l'unico valore che può essere impostato da SetCalendarInfo.

[out, optional] lpCalData

Puntatore a un buffer in cui questa funzione recupera i dati richiesti come stringa. Se CAL_RETURN_NUMBER è specificato in CalType, questo parametro deve recuperare NULL.

[in] cchData

Dimensioni, in caratteri, del buffer lpCalData . L'applicazione può impostare questo parametro su 0 per restituire le dimensioni necessarie per il buffer dei dati del calendario. In questo caso, il parametro lpCalData non viene usato. Se CAL_RETURN_NUMBER viene specificato per CalType, il valore di cchData deve essere 0.

[out, optional] lpValue

Puntatore a una variabile che riceve i dati richiesti come numero. Se CAL_RETURN_NUMBER è specificato in CalType, lpValue non deve essere NULL. Se CAL_RETURN_NUMBER non è specificato in CalType, lpValue deve essere NULL.

Valore restituito

Restituisce il numero di caratteri recuperati nel buffer lpCalData in caso di esito positivo. Se la funzione ha esito positivo, cchData è impostato su 0 e CAL_RETURN_NUMBER non viene specificato, il valore restituito corrisponde alle dimensioni del buffer necessario per contenere le informazioni sulle impostazioni locali. Se la funzione ha esito positivo, cchData è impostato su 0 e CAL_RETURN_NUMBER viene specificato, il valore restituito corrisponde alla dimensione del valore scritto nel parametro lpValue . Questa dimensione è sempre 2.

La funzione restituisce 0 se non riesce. Per ottenere informazioni estese sull'errore, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

  • ERROR_INSUFFICIENT_BUFFER. Le dimensioni del buffer fornite non sono sufficienti o non sono state impostate correttamente su NULL.
  • ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
  • ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Commenti

Nota Questa API viene aggiornata per supportare la modifica dell'era giapponese di maggio 2019. Se l'applicazione supporta il calendario giapponese, è necessario verificare che gestisca correttamente la nuova era. Per altre informazioni, vedere Preparare l'applicazione per la modifica dell'era giapponese .
 
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

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

Vedere anche

Informazioni sul tipo di calendario

GetCalendarInfo

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale

SetCalendarInfo