Funzione EnumDateFormatsExEx (winnls.h)

Articolo
03/13/2024

Enumera i formati di data lunga, data breve o anno/mese disponibili per le impostazioni locali specificate in base al nome.

Nota L'applicazione deve chiamare questa funzione in preferenza per EnumDateFormats o EnumDateFormatsEx 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 EnumDateFormatsExEx(
  [in]           DATEFMT_ENUMPROCEXEX lpDateFmtEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           DWORD                dwFlags,
  [in]           LPARAM               lParam
);

Parametri

[in] lpDateFmtEnumProcExEx

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

[in, optional] lpLocaleName

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

[in] dwFlags

Contrassegno che specifica i formati di data. L'applicazione può fornire uno dei valori seguenti o la costante LOCALE_USE_CP_ACP .

Valore	Significato
DATE_SHORTDATE	Usare formati di data breve. Questo valore non può essere usato con uno qualsiasi degli altri valori di flag.
DATE_LONGDATE	Usare formati di data prolungata. Questo valore non può essere usato con uno qualsiasi degli altri valori di flag.
DATE_YEARMONTH	Usare i formati anno/mese. Questo valore non può essere usato con uno qualsiasi degli altri valori di flag.
DATE_MONTHDAY	Usare i formati mese/giorno. Questo valore non può essere usato con uno qualsiasi degli altri valori di flag.

[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_BADDB. Impossibile accedere ai dati. Questa situazione non dovrebbe normalmente verificarsi e in genere indica un'installazione non valida, un problema del disco o il tipo.
ERROR_INVALID_FLAGS. I valori forniti 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 .

La funzione enumera i formati di data passando puntatori stringa di formato data, uno alla volta, alla funzione di callback definita dall'applicazione, insieme a una costante definita dall'applicazione utile per le applicazioni multi thread. Questo processo continua fino a quando EnumDateFormatsExEx trova il formato dell'ultima data 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

Vedere anche

EnumDateFormats

EnumDateFormatsEx

EnumDateFormatsProcEx

Supporto per la lingua nazionale

Funzioni di supporto del linguaggio nazionale

Condividi tramite