Win32_Directory 类的 CopyEx 方法
CopyExWMI 类方法将对象路径中指定的逻辑目录条目文件或目录复制到 FileName 参数指定的位置。 此方法是 Copy 方法的扩展版本。 如果需要覆盖现有逻辑文件,则不支持复制。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息,请参阅 调用方法。
语法
uint32 CopyEx(
[in] string FileName,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
参数
-
FileName [in]
-
文件副本的完全限定名称 (或目录) 。 示例:c:\temp\newdirectory。
-
StopFileName [out]
-
CopyEx 方法失败的文件或目录的名称。 如果方法成功,此参数将为 null 。
-
StartFileName [in, optional]
-
命名要用作 CopyEx 起点的子文件或目录。 StartFileName 参数通常是 StopFileName 参数,用于指定上一方法调用中发生错误的文件或目录。 如果此参数为 NULL,则对 ExecMethod 调用中指定的文件或目录执行操作。
如果使用 StartFileName ,则 Recursive 也必须设置为 true。
-
递归 [in, 可选]
-
如果 为 true,则将在 CIM_LogicalFile 实例指定的目录中以递归方式复制文件和目录。
注意
对于文件实例,递 归 输入参数将被忽略。
返回值
如果成功复制文件,则返回值 0 (零) ,以及指示错误的任何其他数字。
-
0
-
请求已成功。
-
2
-
访问被拒绝。
-
8
-
发生未指定的故障。
-
9
-
指定的名称无效。
-
10
-
指定的对象已存在。
-
11
-
文件系统不是 NTFS。
-
12
-
平台不是 Windows。
-
13
-
驱动器不同。
-
14
-
目录不为空。
-
15
-
存在共享冲突。
-
16
-
指定的启动文件无效。
-
17
-
不保留操作所需的特权。
-
21
-
指定的参数无效。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista |
最低受支持的服务器 |
Windows Server 2008 |
命名空间 |
Root\CIMV2 |
MOF |
|
DLL |
|