CIM_LogicalFile 类的 Rename 方法

Rename 方法重命名对象路径中指定的逻辑文件 (或目录) 。 如果目标位于另一个驱动器上，或者需要覆盖现有逻辑文件，则不支持重命名。

重要

DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构。

本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。

语法

uint32 Rename(
  [in] string FileName
);

参数

FileName [in]

完全限定的新文件 (或目录) 名称。

示例：“c:\temp\newfile.txt”

返回值

返回一个值 0 (零成功时) ，以及指示错误的任何其他数字。

Success

0

成功。

拒绝访问

2

访问被拒绝。

未知故障

8

未指定的故障。

对象无效

9

对象无效。

对象已存在

10

对象已存在。

文件系统不是 NTFS

11

文件系统不是 NTFS。

平台而非 NT/Windows 2000

12

平台而不是 Windows。

驱动器不同

13

驱动器不同。

目录不为空

14

目录不为空。

共享冲突

15

共享冲突。

启动文件无效

16

启动文件无效。

未保留权限

17

未保留权限。

参数无效

21

参数无效。

备注

WMI 当前未实现此方法。 若要使用此方法，必须在自己的提供程序中实现它。

本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已对更正小错误、符合 Microsoft SDK 文档标准或提供详细信息进行了更改。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

CIM_LogicalFile

CIM_LogicalFile