| INT GetFileTime( |
| |
LPCTSTR lpszFileName, |
|
| |
LPSYSTEMTIME lpFileTime, |
|
| |
BOOL bLocalize |
|
| ); |
The GetFileTime method returns the modification time for
the specified file on the server.
Parameters
- lpszFileName
- Points to a string that specifies the name of
the remote file.
- lpFileTime
- Points to a SYSTEMTIME structure
that will be set to the current modification time for the remote
file.
- bLocalize
- A boolean flag which specifies if the file time is localized to
the current timezone. If this value is non-zero, then the file time
is adjusted to that the time is local to the current system. If
this value is zero, the file time is returned in UTC time.
Return Value
If the method succeeds, the return value is the server result
code. If the method fails, the return value is FTP_ERROR. To get
extended error information, call GetLastError.
Remarks
The GetFileTime method can be used to determine the date
and time that a file was last modified on the server. The time may
either be localized to the current system, or it may be returned as
UTC time. If you plan on changing the values returned in the
SYSTEMTIME structure and then calling SetFileTime method to
modify the file time on the server, you should do not localize the
time.
This method uses the MDTM command to determine the modification
time of the specified file. If the server does not support this
command, the method will attempt to use the STAT command to determine
the file modification time.
Requirements
Minimum Desktop Platform: Windows 7 (Service Pack 1)
Minimum Server Platform: Windows Server 2008 R2 (Service Pack 1)
Header File: cstools10.h
Import Library: csftpv10.lib
Unicode: Implemented as Unicode and ANSI versions.
See Also
GetFileStatus,
OpenDirectory,
SetFileTime
|