Struttura FILETIME (minwinbase.h)

Articolo
02/29/2024

Contiene un valore a 64 bit che rappresenta il numero di intervalli da 100 nanosecondi dal 1° gennaio 1601 (UTC).

Sintassi

typedef struct _FILETIME {
  DWORD dwLowDateTime;
  DWORD dwHighDateTime;
} FILETIME, *PFILETIME, *LPFILETIME;

Members

dwLowDateTime

Parte bassa dell'ordine del file.

dwHighDateTime

Parte elevata dell'ora del file.

Commenti

Per convertire una struttura FILETIME in un momento che è facile da visualizzare a un utente, usare la funzione FileTimeToSystemTime .

Non è consigliabile aggiungere e sottraere valori dalla struttura FILETIME per ottenere tempi relativi. È invece necessario copiare le parti di ordine basso e elevato del tempo di file in una struttura ULARGE_INTEGER , eseguire aritmetica a 64 bit nel membro QuadPart e copiare i membri LowPart e HighPart nella struttura FILETIME .

Non eseguire il cast di un puntatore a una struttura FILETIME a un valore ULARGE_INTEGER* o __int64* perché può causare errori di allineamento in Windows a 64 bit.

Non tutti i file system possono registrare la creazione e l'ultima volta di accesso e non tutti i file system li registrano nello stesso modo. Ad esempio, in NT FAT, il tempo di creazione ha una risoluzione di 10 millisecondi, il tempo di scrittura ha una risoluzione di 2 secondi e l'ora di accesso ha una risoluzione di 1 giorno (in realtà, la data di accesso). In NTFS, l'ora di accesso ha una risoluzione di 1 ora. Pertanto, la funzione GetFileTime potrebbe non restituire le stesse informazioni relative al tempo di file impostate usando la funzione SetFileTime . Inoltre, i record FAT sul disco vengono registrati in tempo locale. Tuttavia, i record NTFS vengono registrati su disco in formato UTC. Per altre informazioni, vedere Tempi file.

Una funzione che usa la struttura FILETIME può consentire valori esterni a zero o valori positivi in genere specificati dai membri dwLowDateTime e dwHighDateTime. Ad esempio, la funzione SetFileTime usa 0xFFFFFFFF per specificare che l'ora di accesso precedente di un file deve essere mantenuta. Per altre informazioni, vedere l'argomento relativo alla funzione che si sta chiamando.

Esempio

Per un esempio, vedere Modifica di un'ora file all'ora corrente o recupero dell'ora Last-Write.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Intestazione	minwinbase.h (includere Windows.h)

Vedi anche