Funzione FileTimeToDosDateTime (winbase.h)

  • Articolo

Converte un'ora di file in valori di data e ora MS-DOS.

Sintassi

BOOL FileTimeToDosDateTime(
  [in]  const FILETIME *lpFileTime,
  [out] LPWORD         lpFatDate,
  [out] LPWORD         lpFatTime
);

Parametri

[in] lpFileTime

Puntatore a una struttura FILETIME contenente l'ora di file da convertire in formato data e ora MS-DOS.

[out] lpFatDate

Puntatore a una variabile per ricevere la data MS-DOS. La data è un valore compresso con il formato seguente.

BITS Descrizione
0–4 Giorno del mese (1-31)
5–8 Mese (1 = gennaio, 2 = febbraio e così via)
9-15 Offset dell'anno dal 1980 (aggiunta 1980 per ottenere l'anno effettivo)

[out] lpFatTime

Puntatore a una variabile per ricevere il tempo MS-DOS. L'ora è un valore compresso con il formato seguente.

BITS Descrizione
0–4 Secondo diviso per 2
5–10 Minuto (0-59)
11–15 Ora (0-23 su un orologio di 24 ore)

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il formato di data MS-DOS può rappresentare solo date tra 1/1/1980 e 12/31/2107; questa conversione ha esito negativo se il tempo del file di input non è compreso in questo intervallo.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

DosDateTimeToFileTime

FileTimeToSystemTime

SystemTimeToFileTime

Funzioni temporali