IPropertyStorage::SetTimes method (propidl.h)

Article
10/24/2022

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

[in] pctime

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.

[in] patime

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.

[in] pmtime

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:

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 SetTimes is used, the latest specified times supersede either default times or time values specified in previous calls to SetTimes.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps \| UWP apps]
Minimum supported server	Windows 2000 Server [desktop apps \| UWP apps]
Target Platform	Windows
Header	propidl.h (include Objbase.h, Propidlbase.h)
Library	Uuid.lib
DLL	Ole32.dll