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 为此存储对象中的指定存储元素设置时间统计信息。
并非所有文件系统都支持所有时间值。 此方法设置受支持的时间,并忽略其余时间。 每个时间值参数可以为 NULL;指示不应进行修改。
调用 IStorage::Stat 方法来检索这些时间值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | objidl.h |
Library | Uuid.lib |
DLL | Ole32.dll |