IResultData2::RenameResultItem 方法 (mmc.h)
RenameResultItem 方法以编程方式将指定的结果项置于重命名模式,然后用户可以手动输入新名称。 此方法专为创建项且必须立即置于重命名模式的情况而设计。 不支持在其他情况下使用此方法,例如在选择项后调用此方法,并且可能会产生意外的结果。
语法
HRESULT RenameResultItem(
[in] HRESULTITEM itemID
);
参数
[in] itemID
将结果项置于重命名模式。 应用于虚拟列表时,传递项索引而不是结果项。
返回值
如果成功,则返回值为S_OK;否则,返回值为错误代码。 SUCCEEDED 和/或 FAILED 宏可用于计算返回值。 如果未启用 Rename 谓词,此方法将返回E_FAIL。
注解
放入重命名模式的项必须启用 Rename 谓词,此方法才能成功。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | mmc.h |
Library | Mmc.lib |
DLL | Mmcndmgr.dll |