IStorage::SetElementTimes method (objidl.h)

Article
10/13/2021

The SetElementTimes method sets the modification, access, and creation times of the specified storage element, if the underlying file system supports this method.

Syntax

HRESULT SetElementTimes(
  [in] const OLECHAR  *pwcsName,
  [in] const FILETIME *pctime,
  [in] const FILETIME *patime,
  [in] const FILETIME *pmtime
);

Parameters

[in] pwcsName

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] pctime

Either the new creation time for the element or NULL if the creation time is not to be modified.

[in] patime

Either the new access time for the element or NULL if the access time is not to be modified.

[in] pmtime

Either the new modification time for the element or NULL if the modification time is not to be modified.

Return value

This method can return one of these values.

Return code	Description
S_OK	The time values were successfully set.
E_PENDING	Asynchronous Storage only: Part or all of the element's data is currently unavailable.
STG_E_ACCESSDENIED	The caller does not have enough permissions for changing the element.
STG_E_FILENOTFOUND	The element with the specified name does not exist.
STG_E_INSUFFICIENTMEMORY	The element was not changed due to a lack of memory.
STG_E_INVALIDNAME	Not a valid value for the element name.
STG_E_INVALIDPOINTER	The pointer specified for the element was not valid.
STG_E_INVALIDPARAMETER	One of the parameters was not valid.
STG_E_TOOMANYOPENFILES	The element was not changed because there are too many open files.
STG_E_REVERTED	The storage object has been invalidated by a revert operation above it in the transaction tree.

Remarks

SetElementTimes sets time statistics for the specified storage element within this storage object.

Not all file systems support all the time values. This method sets those times that are supported and ignores the rest. Each time-value parameter can be NULL; indicating that no modification should occur.

Call the IStorage::Stat method to retrieve these time values.

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	objidl.h
Library	Uuid.lib
DLL	Ole32.dll