Поделиться через


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

Метод 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 Объект хранилища был признан недействительным в результате операции отменить изменения над ним в дереве транзакций.

Комментарии

SetElementTimes задает статистику времени для указанного элемента хранилища в этом объекте хранилища.

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

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

Требования

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

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

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

IStorage::Stat