Export (0) Print
Expand All

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

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

Propidl.h (include Objbase.h)

Library

Uuid.lib

DLL

Ole32.dll

IID

IID_IPropertyStorage is defined as 00000138-0000-0000-C000-000000000046

See also

IPropertyStorage::Stat
FILETIME

 

 

Community Additions

ADD
Show:
© 2015 Microsoft