Funzione EnumTimeFormatsA (winnls.h)

Articolo
11/20/2024

Enumera i formati di ora disponibili per le impostazioni locali specificate dall'identificatore.

Nota Per motivi di interoperabilità, l'applicazione deve preferire la funzione EnumTimeFormatsEx a EnumTimeFormats perché Microsoft sta eseguendo la migrazione verso l'uso dei nomi delle impostazioni locali anziché degli identificatori delle impostazioni locali per le nuove impostazioni locali. Qualsiasi applicazione eseguita solo in Windows Vista e versioni successive deve usare EnumTimeFormatsEx.

Sintassi

BOOL EnumTimeFormatsA(
  [in] TIMEFMT_ENUMPROCA lpTimeFmtEnumProc,
  [in] LCID              Locale,
  [in] DWORD             dwFlags
);

Parametri

[in] lpTimeFmtEnumProc

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

[in] Locale

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

[in] dwFlags

Formato ora. Questo parametro può specificare una combinazione di uno dei valori seguenti.

Bandiera	Significato
0	Usa il formato di tempo lungo dell'utente corrente.
TIME_NOSECONDS	Windows 7 e versioni successive: usa il formato di tempo breve dell'utente corrente. Nota Questo valore non funzionerà con la versione ANSI di questa funzione, EnumTimeFormatsA.
LOCAL_USE_CP_ACP	Specificato con la versione ANSI di questa funzione, EnumTimeFormatsA (scelta non consigliata), per usare la tabella codici PREDEFINITa di Windows ANSI (ACP) anziché la tabella codici delle impostazioni locali.

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.

Osservazioni

La funzione enumera i formati temporali passando un puntatore a un buffer contenente un formato ora a una funzione di callback definita dall'applicazione. Il primo valore nell'enumerazione è sempre il valore predefinito dell'utente (override). La funzione continua l'enumerazione fino a quando non viene trovato l'ultimo formato o la funzione di callback restituisce FALSE.

Questa funzione può enumerare i dati dalle impostazioni locali personalizzate . Non è garantito che i dati siano uguali da computer a computer o tra esecuzioni di un'applicazione. Se l'applicazione deve rendere persistenti o trasmettere i dati, vedere Using Persistent Locale Data.

Quando la versione ANSI di questa funzione viene usata con un identificatore delle impostazioni locali solo Unicode, la chiamata può avere esito positivo perché il sistema usa la tabella codici di sistema. Tuttavia, i caratteri non definiti nella tabella codici di sistema vengono visualizzati nella stringa come punto interrogativo ("?"). Si noti che tutti i nuovi valori per dwFlags introdotti in futuro non funzioneranno con la versione ANSI.

Nota

L'intestazione winnls.h definisce EnumTimeFormats 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winnls.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

EnumTimeFormatsEx

EnumTimeFormatsProc

supporto linguistico nazionale

funzioni di supporto del linguaggio nazionale

Condividi tramite