Funzione EnumDateFormatsExW (winnls.h)
Enumera i formati di data lunga, data breve o anno/mese disponibili per le impostazioni locali specificate.
Sintassi
BOOL EnumDateFormatsExW(
[in] DATEFMT_ENUMPROCEXW 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 della data. È possibile utilizzare la macro MAKELCID per creare un identificatore o usare uno dei valori predefiniti seguenti.
Windows Vista e versioni successive: Sono supportati anche gli identificatori di impostazioni locali personalizzati seguenti.[in] dwFlags
Flag 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 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 tutti i formati di data per le impostazioni locali specificate, inclusi i calendari alternativi, se presenti. Tuttavia, l'identificatore del calendario non viene enumerato insieme al formato data, rendendo difficile l'uso dei formati per le impostazioni locali con calendari alternativi.
Questa funzione può enumerare i dati dalle impostazioni locali personalizzate. Non è garantito che i dati siano gli stessi dal computer al computer o tra le esecuzioni di un'applicazione. Se l'applicazione deve rendere persistenti o trasmettere i dati, vedere Uso dei dati delle impostazioni 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
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 (include Windows.h) |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |