CIM_DeviceFile 类的 TakeOwnerShipEx 方法

TakeOwnerShipEx 方法获取对象路径中指定的逻辑设备文件的所有权。此方法是 TakeOwnerShip 方法的扩展版本，继承自 CIM_LogicalFile。如果逻辑文件是目录，则此方法以递归方式运行，获取该目录包含的所有文件和子目录的所有权。

重要

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

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

语法

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

StopFileName [out]: 字符串，表示方法失败的文件 (或目录) 的名称。如果方法成功，此参数为 null 。
StartFileName [in]: 字符串，表示子文件 (或目录) 用作此方法的起点。通常， StartFileName 参数是 StopFileName 参数，用于指定上一方法调用中发生错误的文件或目录。如果此参数为 null，则对 ExecMethod 调用中指定的文件或目录执行操作。
递归 [in]: 如果 为 TRUE，则该方法还会以递归方式应用于 CIM_DeviceFile 实例指定的目录中的文件和目录。对于文件实例，将忽略此参数。

返回一个值 0 (零) 成功，并返回指示错误的任何其他数字。

成功。

访问被拒绝。

未指定的失败。

对象无效。

对象已存在。

文件系统不是 NTFS。

平台而不是 Windows。

驱动器不同。

目录不为空。

共享冲突。

启动文件无效。

未持有特权。

参数无效。

此方法当前未由 WMI 实现。若要使用此方法，必须在自己的提供程序中实现此方法。

本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已做出更改以更正小错误、符合 Microsoft SDK 文档标准或提供详细信息。