IPropertyStorage::SetTimes
Sets the
modification, access, and creation times of this property set, if supported by
the implementation. Not all implementations support all these time values.
HRESULT
SetTimes(
|
FILETIME
const * pctime, |
//New creation time for the property set |
|
FILETIME
const * patime, |
//New access time for the property set |
|
FILETIME
const * pmtime |
//New modification time for the property set |
|
); |
|
Parameters
pctime
[in] Pointer
to the new creation time for the property set. May be NULL, indicating that
this time is not to be modified by this call.
patime
[in] Pointer
to the new access time for the property set. May be NULL, indicating that this
time is not to be modified by this call.
pmtime
[in] Pointer
to the new modification time for the property set. May be NULL, indicating that
this time is not to be modified by this call.
Return Values
This method
supports the standard return value E_UNEXPECTED, as well as the following:
S_OK
All the
requested times have been successfully updated.
STG_E_ACCESSDENIED
The requested
access to the property storage object has been denied; no times have been updated.
STG_E_INSUFFICIENTMEMORY
There is not
sufficient memory to perform this operation.
STG_E_INVALIDPARAMETER
The parameter
is invalid. This error is returned if an attempt is made to set a time value
which is not supported by this implementation.
Remarks
Sets the
modification, access, and creation times of the current open property set, if
supported by the implementation (not all implementations support all these time
values). Unsupported timestamps are always reported as zero, enabling the
caller to test for support. A call to IPropertyStorage::Stat supplies
(among other information) timestamp information.
Notice that
this functionality is provided as an IPropertyStorage method on a property
storage object that is already open, in contrast to being provided as a method
in IPropertySetStorage. Normally, when the SetTimes method is not
explicitly called, the access and modification times are updated as a side
effect of reading and writing the property set. When SetTimes is used,
the latest specified times supersede either default times or time values
specified in previous calls to SetTimes.
See Also