Funzione EnumDateFormatsExA (winnls.h)

  • Articolo

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

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

Sintassi

BOOL EnumDateFormatsExA(
  [in] DATEFMT_ENUMPROCEXA lpDateFmtEnumProcEx,
  [in] LCID                Locale,
  [in] DWORD               dwFlags
);

Parametri

[in] lpDateFmtEnumProcEx

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

[in] Locale

Identificatore delle impostazioni locali che specifica le impostazioni locali per cui recuperare le informazioni sul formato data. È possibile usare la macro MAKELCID per creare un identificatore o usare uno dei valori predefiniti seguenti.

Windows Vista e versioni successive: Sono supportati anche gli identificatori delle impostazioni locali personalizzate seguenti.

[in] dwFlags

Contrassegno che specifica i formati di data. Per definizioni dettagliate, vedere il parametro dwFlags di EnumDateFormatsExEx.

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

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 specificata. Questo processo continua fino a quando EnumDateFormatsEx trova il formato dell'ultima data o la funzione di callback restituisce FALSE.

Questa funzione enumera tutti i formati di data per le impostazioni locali specificate, inclusi calendari alternativi, se presenti. Tuttavia, l'identificatore del calendario non è enumerato insieme al formato data, rendendo i formati per le impostazioni locali con calendari alternativi difficili da usare.

Questa funzione può enumerare i dati dalle impostazioni locali personalizzate. I dati non sono garantiti come uguali da computer a computer o tra esecuzioni di un'applicazione. Se l'applicazione deve mantenere o trasmettere dati, vedere Uso di dati 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 (?).

L'applicazione deve usare EnumDateFormatsEx (anziché EnumDateFormats ) per enumerare i formati di data per le impostazioni locali con calendari alternativi.

Nota

L'intestazione winnls.h definisce EnumDateFormatsEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
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 (includere Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

EnumDateFormats

EnumDateFormatsExEx

EnumDateFormatsProcEx

Supporto per la lingua nazionale

Funzioni di supporto del linguaggio nazionale