IPropertyStorage::SetTimes method

The SetTimes method sets the modification, access, and creation times of this property set, if supported by the implementation. Not all implementations support all these time values.

Syntax

HRESULT SetTimes(
  [in] const FILETIME *pctime,
  [in] const FILETIME *patime,
  [in] const FILETIME *pmtime
);

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 value

This method supports the standard return value E_UNEXPECTED, in addition to 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 enough memory to perform this operation.

STG_E_INVALIDPARAMETER

The parameter is not valid. This error is returned if an attempt is made to set a time value 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 time stamps are always reported as zero, enabling the caller to test for support. A call to IPropertyStorage::Stat supplies (among other data) time-stamp 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 SetTimesis used, the latest specified times supersede either default times or time values specified in previous calls to SetTimes.

Requirements

See also

IPropertyStorage::Stat

FILETIME