windows_programming_notes.nbk: Home | Index | Next Page: FindResource | Previous Page: ExtTextOut

 FILETIME

The FILETIME structure is a 64-bit value representing the number of 100-nanosecond intervals since January 1, 1601 (UTC).

Syntax

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

Members

dwLowDateTime
Specifies the low-order 32 bits of the file time.
dwHighDateTime
Specifies the high-order 32 bits of the file time.

Remarks

To convert a FILETIME structure into a time that is easy to display to a user, use the FileTimeToSystemTime function. It is not recommended that you add and subtract values from the FILETIME structure to obtain relative times. Instead, you should
• Copy the resulting FILETIME structure to a ULARGE_INTEGER structure.
• Use normal 64-bit arithmetic on the ULARGE_INTEGER value.
Not all file systems can record creation and last access time and not all file systems record them in the same manner. For example, on NT FAT, create time has a resolution of 10 milliseconds, write time has a resolution of 2 seconds, and access time has a resolution of 1 day (really, the access date). On NTFS, access time has a resolution of 1 hour. Therefore, the GetFileTime function may not return the same file time information set using the SetFileTime function. Furthermore, FAT records times on disk in local time. However, NTFS records times on disk in UTC. For more information, see File Times.

Requirements

Windows NT/2000 or later: Requires Windows NT 3.1 or later. Windows 95/98/Me: Requires Windows 95 or later. Header: Declared in Winbase.h; include Windows.h.

windows_programming_notes.nbk: Home | Index | Next Page: FindResource | Previous Page: ExtTextOut

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time