CIM_Directory 类的 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]
-
字符串,表示子文件 (或目录) 用作此方法的起点。 通常,此参数是 StopFileName 参数,用于指定在上一方法调用中发生错误的文件或目录。 如果此参数为 null,则对 ExecMethod 调用中指定的文件 (或目录) 执行操作。
-
递归 [in]
-
如果 为 True,则该方法以递归方式应用于 CIM_Directory 实例指定的目录中的文件和目录。 对于文件实例,将忽略此参数。
返回值
成功时返回值 0,返回指示错误的任何其他数字。
-
0
成功。
-
2
访问被拒绝。
-
8
未指定的失败。
-
9
对象无效。
-
10
对象已存在。
-
11
文件系统不是 NTFS。
-
12
平台不是 Windows。
-
13
驱动器不同。
-
14
目录不为空。
-
15
共享冲突。
-
16
启动文件无效。
-
17
未持有特权。
-
21
参数无效。
备注
此方法当前未由 WMI 实现。 若要使用此方法,必须在自己的提供程序中实现此方法。
本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已做出更改以更正小错误、符合 Microsoft SDK 文档标准或提供详细信息。
示例
以下 Visual Basic 脚本代码调用 TakeOwnerShipEx 方法获取 C:\temp 文件夹的所有权。
strComputer = "."
Set objWMIService = GetObject( _
"winmgmts:\\" & strComputer & "\root\CIMV2")
' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")
' Obtain an InParameters object specific
' to the method.
Set objInParam = objShare.Methods_("TakeOwnerShipEx"). _
inParameters.SpawnInstance_()
' Add the input parameters.
objInParam.Properties_.Item("Recursive") = true
' Execute the method and obtain the return status.
' The OutParameters object in objOutParams
' is created by the provider.
Set objOutParams = objWMIService.ExecMethod( _
"Win32_Directory.Name='C:\Temp'", "TakeOwnerShipEx", objInParam)
wscript.echo objOutParams.ReturnValue
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista |
最低受支持的服务器 |
Windows Server 2008 |
命名空间 |
Root\CIMV2 |
MOF |
|
DLL |
|