Win32_ShortcutFile类的 TakeOwnerShipEx 方法
TakeOwnerShipExWMI类方法获取对象路径中指定的逻辑快捷文件的所有权。 此方法是 TakeOwnerShip 方法的扩展版本。 如果逻辑文件实际上是一个目录,则此方法以递归方式执行操作,获取目录包含的所有文件和子目录的所有权。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息,请参阅 调用方法。
语法
uint32 TakeOwnerShipEx(
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
parameters
-
StopFileName [out]
-
TakeOwnerShipEx 方法失败的文件或目录的名称。 如果方法成功,此参数将为 null 。
-
StartFileName [in, 可选]
-
将子文件或目录命名为 TakeOwnerShipEx 的起点。 StartFileName 参数通常是 StopFileName 参数,用于指定发生上一方法调用错误的文件或目录。 如果此参数为 NULL,则对 ExecMethod 调用中指定的文件或目录执行该操作。
-
递归 [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 |
|