Метод IStorage::SetElementTimes (objidl.h)

Статья
03/05/2024

Метод SetElementTimes задает время изменения, доступа и создания указанного элемента хранилища, если базовая файловая система поддерживает этот метод.

Синтаксис

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

Параметры

[in] pwcsName

Имя элемента объекта хранилища, время которого необходимо изменить. Если значение РАВНО NULL, время задается в корневом хранилище, а не в одном из его элементов.

[in] pctime

Либо новое время создания элемента, либо значение NULL , если время создания не должно быть изменено.

[in] patime

Либо новое время доступа для элемента, либо значение NULL , если время доступа не должно быть изменено.

[in] pmtime

Либо новое время изменения для элемента, либо значение NULL , если время изменения не должно быть изменено.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Значения времени успешно заданы.
E_PENDING	Только асинхронное хранилище. Часть или все данные элемента в настоящее время недоступны.
STG_E_ACCESSDENIED	Вызывающий объект не имеет достаточных разрешений для изменения элемента.
STG_E_FILENOTFOUND	Элемент с указанным именем не существует.
STG_E_INSUFFICIENTMEMORY	Элемент не был изменен из-за нехватки памяти.
STG_E_INVALIDNAME	Недопустимое значение для имени элемента.
STG_E_INVALIDPOINTER	Недопустимый указатель, указанный для элемента .
STG_E_INVALIDPARAMETER	Один из параметров был недопустим.
STG_E_TOOMANYOPENFILES	Элемент не был изменен, так как открыто слишком много файлов.
STG_E_REVERTED	Объект хранилища был признан недействительным в результате операции отменить изменения над ним в дереве транзакций.

Не все файловые системы поддерживают все значения времени. Этот метод задает поддерживаемые значения времени, а остальные игнорируются. Каждый параметр time-value может иметь значение NULL; указывает, что никаких изменений не должно происходить.

Вызовите метод IStorage::Stat , чтобы получить эти значения времени.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	objidl.h
Библиотека	Uuid.lib
DLL	Ole32.dll

См. также раздел

IStorage — реализация составного файла

IStorage::Stat