Funzione EnumTimeFormatsEx (winnls.h)

Articolo
03/13/2024

Enumera i formati di ora disponibili per le impostazioni locali specificate in base al nome.

Nota L'applicazione deve chiamare questa funzione in preferenza a EnumTimeFormats 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 rendere persistenti o trasmettere i dati, vedere Uso dei dati delle impostazioni locali persistenti.

Sintassi

BOOL EnumTimeFormatsEx(
  [in]           TIMEFMT_ENUMPROCEX lpTimeFmtEnumProcEx,
  [in, optional] LPCWSTR            lpLocaleName,
  [in]           DWORD              dwFlags,
  [in]           LPARAM             lParam
);

Parametri

[in] lpTimeFmtEnumProcEx

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

[in, optional] lpLocaleName

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

[in] dwFlags

Formato dell'ora. Impostare su 0 per usare il formato di tempo lungo dell'utente corrente o TIME_NOSECONDS (a partire da Windows 7) per usare il formato di breve tempo.

[in] lParam

Parametro fornito dall'applicazione da passare alla funzione di callback. Ciò è particolarmente utile per le applicazioni multithreading.

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 i formati temporali passando puntatori di stringa di formato temporale, uno alla volta, alla funzione di callback definita dall'applicazione specificata, insieme a una costante definita dall'applicazione utile per le applicazioni multithreading. Il primo valore nell'enumerazione è sempre il valore predefinito dell'utente (override). La funzione continua l'enumerazione finché non viene trovato l'ultimo formato 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 (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

EnumTimeFormats

EnumTimeFormatsProcEx

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale

Condividi tramite