IStorage::RenameElement 方法 (objidl.h)
RenameElement 方法重命名此存储对象中的指定子存储或流。
语法
HRESULT RenameElement(
[in] const OLECHAR *pwcsOldName,
[in] const OLECHAR *pwcsNewName
);
参数
[in] pwcsOldName
指向以 null 结尾的宽字符 Unicode 字符串的指针,该字符串包含要更改的子存储或流的名称。
注意在 CreateStorage 或 CreateStream 中创建的 pwcsName 的长度不得超过 31 个字符,不包括字符串终止符。
[in] pwcsNewName
指向以 null 结尾的宽字符 unicode 字符串的指针,该字符串包含指定子存储或流的新名称。
注意在 CreateStorage 或 CreateStream 中创建的 pwcsName 的长度不得超过 31 个字符,不包括字符串终止符。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
S_OK | 已成功重命名元素。 |
E_PENDING | 仅限异步存储:元素的部分或全部数据当前不可用。 |
STG_E_ACCESSDENIED | 调用方没有足够的权限来重命名元素。 |
STG_E_FILENOTFOUND | 具有指定旧名称的元素不存在。 |
STG_E_FILEALREADYEXISTS | 新名称指定的元素已存在。 |
STG_E_INSUFFICIENTMEMORY | 由于内存不足,元素未重命名。 |
STG_E_INVALIDNAME | 其中一个名称的值无效。 |
STG_E_INVALIDPOINTER | 为元素指定的指针无效。 |
STG_E_INVALIDPARAMETER | 其中一个参数无效。 |
STG_E_REVERTED | 事务树中存储对象上方的还原操作已失效。 |
STG_E_TOOMANYOPENFILES | 元素未重命名,因为打开的文件太多。 |
注解
IStorage::RenameElement 重命名此存储对象中的指定子存储或流。 存储对象中的元素在打开时无法重命名。 如果存储以事务处理模式打开,则重命名操作会提交更改。
IStorage::RenameElement 方法不能保证在低内存中工作,存储对象在事务处理模式下打开。 它可能在直接模式下工作。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | objidl.h |
Library | Uuid.lib |
DLL | Ole32.dll |