CIM_LogicalFile 类的 CopyEx 方法
CopyEx 方法将对象路径中指定的逻辑文件 (或目录) 复制到 FileName 参数指定的位置。 如果需要覆盖现有逻辑文件,则不支持复制。 此方法是 Copy 方法的扩展版本。
重要
DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息,请参阅 调用方法。
语法
uint32 CopyEx(
[in] string FileName,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
参数
-
FileName [in]
-
目标文件 (或目录) 的完全限定名称。
示例:“c:\temp\newdirectory”
-
StopFileName [out]
-
字符串,表示方法失败的文件 (或目录) 的名称。 如果方法成功,此参数为 null 。
-
StartFileName [in, optional]
-
将子文件命名为 (或目录的字符串,) 用作此方法的起点。 通常, StartFileName 参数是 StopFileName 参数,用于指定文件 (或目录) 之前的方法调用中发生错误。 如果此参数为 null,则对 ExecMethod 调用中指定的文件或目录执行操作。
-
递归 [in, 可选]
-
如果为 TRUE,则该方法还会以递归方式应用于 CIM_LogicalFile 实例指定的目录中的文件和目录。 对于文件实例,将忽略此参数。
返回值
返回一个值 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 |
|
DLL |
|