Метод 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 |