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.

STG_E_SHAREVIOLATION

Access denied because another caller has the file open and locked.

This function can also return any file system errors or Win32 errors wrapped in an HRESULT.

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.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in objbase.h.
  Import Library: Included as a resource in ole32.dll.