CIM_LogicalFile 类的 TakeOwnerShipEx 方法

TakeOwnerShipEx 方法获取对象路径中指定的逻辑文件的所有权。 此方法是 TakeOwnerShip 方法的扩展版本。 如果逻辑文件是目录,则此方法以递归方式执行操作,获取目录包含的所有文件和子目录的所有权。

重要

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

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

语法

uint32 TakeOwnerShipEx(
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

parameters

StopFileName [out]

表示方法失败的文件的名称 (或目录) 的字符串。 如果方法成功,此参数为 null

StartFileName [in, 可选]

将子文件命名为 (或目录) 用作方法起点的字符串。 通常,此参数是 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
CIMWin32.mof
DLL
CIMWin32.dll

另请参阅

CIM_LogicalFile

CIM_LogicalFile