StgSetTimes
Sets the
creation, access, and modification times of the indicated file, if supported by
the underlying file system.
WINOLEAPI StgSetTimes(
|
WCHAR const * lpszName, |
//Points
to the name of the file to be changed |
|
FILETIME const * pctime, |
//Points
to the new value for the creation time |
|
FILETIME const * patime, |
//Points
to the new value for the access time |
|
FILETIME const * pmtime |
//Points
to the new value for the modification time |
|
); |
|
Parameters
lpszName
[in] Points
to the name of the file to be changed.
pctime
[in] Points
to the new value for the creation time.
patime
[in] Points
to the new value for the access time.
pmtime
[in] Points
to the new value for the modification time.
Return Values
S_OK
Indicates
time values successfully set.
STG_E_FILENOTFOUND
Indicates
element does not exist.
STG_E_INVALIDNAME
Indicates bad
name passed in the lpszName parameter, or a file system error.
STG_E_ACCESSDENIED
Access denied
because the caller has insufficient permission, or another caller has the file
open and locked.
STG_E_LOCKVIOLATION
Access denied
because another caller has the file open and locked.
File system
error return values.
Remarks
The StgSetTimes
function sets the time values for the specified file. Each of the time value
parameters can be NULL, indicating no modification should occur.
It is
possible that one or more of these time values are not supported by the
underlying file system. This function sets the times that can be set and
ignores the rest.