CIM_DataFile 类的 CopyEx 方法
CopyEx 方法将对象路径中指定的逻辑文件 (或目录) 复制到 FileName 参数指定的位置。 如果复制需要覆盖现有逻辑文件，则不支持复制。 此方法是 Copy 方法的扩展版本，继承自 CIM_LogicalFile。
重要
DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。
语法
uint32 CopyEx(
[in] string FileName,
[out] string REF StopFileName,
[in] string StartFileName,
[in] boolean Recursive
);
参数
-
FileName [in]
-
目标文件 (或目录) 的完全限定名称。
示例：“c：\temp\newdirectory”
-
StopFileName [out]
-
表示方法失败的文件 (或目录) 名称的字符串。 如果方法成功，此参数将为 null 。
-
StartFileName [in]
-
表示子文件 (或目录) 用作此方法起点的字符串。 通常， StartFileName 参数是 StopFileName 参数，用于指定文件 (或目录) 之前的方法调用发生错误。 如果此参数为 null，则会对 ExecMethod 调用中指定的文件 (或目录) 执行操作。
如果使用 StartFileName ，则 Recursive 也必须设置为 true。
-
递归 [in]
-
如果为 TRUE，则该方法还会以递归方式应用于 CIM_DataFile 实例指定的目录中的文件和目录。 对于文件实例，将忽略此参数。
返回值
返回一个值 0 (零成功时) ，以及指示错误的任何其他数字。 有关其他错误代码，请参阅 WMI 错误常量 或 WbemErrorEnum。 有关常规 HRESULT 值，请参阅 系统错误代码。
-
0
成功。
-
2
访问被拒绝。
-
8
未指定的故障。
-
9
对象无效。
-
10
对象已存在。
-
11
文件系统不是 NTFS。
-
12
平台而不是 Windows。
-
13
驱动器不同。
-
14
目录不为空。
-
15
共享冲突。
-
16
启动文件无效。
-
17
未保留权限。
-
21
参数无效。
备注
CIM_DataFile 中的 CopyEx 方法由 WMI 实现。
本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已对更正小错误、符合 Microsoft SDK 文档标准或提供详细信息进行了更改。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista |
| 最低受支持的服务器 |
Windows Server 2008 |
| 命名空间 |
Root\CIMV2 |
| MOF |
|
| DLL |
|