# 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.