Sets the modification, access, and creation times of the specified storage
element, if supported by the underlying file system.
| const wchar_t * pwcsName,
||//Points to name of element to be changed
| FILETIME const * pctime,
||//New creation time for element, or NULL
| FILETIME const * patime,
||//New access time for element, or NULL
| FILETIME const * pmtime
||//New modification time for element, or NULL
[in]The name of the storage object element whose times are to be modified. If
NULL, the time is set on the root storage rather than one of its elements.
[in]Either the new creation time for the element or NULL if the creation time
is not to be modified.
[in]Either the new access time for the element or NULL if the access time is
not to be modified.
[in]Either the new modification time for the element or NULL if the
modification time is not to be modified.
The time values were successfully set.
The caller does not have sufficient permissions for changing the element.
The element with the specified name does not exist.
The element was not changed due to a lack of memory.
Invalid value for the element name.
The pointer specified for the element was invalid.
One of the parameters was invalid.
The object has been invalidated by a revert operation above it in the
The element was not changed because there are too many open files.
This method sets time statistics for the specified storage element within this
Not all file systems support all of the time values. This method sets those
times that are supported and ignores the rest. Each of the time value parameters
can be NULL; indicating that no modification should occur.
You can retrieve these time values with the IStorage::Stat
Note to Callers
The OLE-provided compound file implementation maintains modification and
change times for internal storage objects. For root storage objects, whatever is
supported by the underlying file system (or ILockBytes
) is supported. The compound file implementation does not maintain any time
stamps for internal streams. Unsupported time stamps are reported as zero,
enabling the caller to test for support.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages