Win32_Directory クラスの TakeOwnerShipEx メソッド
TakeOwnerShipExWMI クラス メソッドは、オブジェクト パスで指定された論理ディレクトリ エントリ ファイルの所有権を取得します。 このメソッドは 、TakeOwnerShip メソッドの拡張バージョンです。 論理ファイルが実際にはディレクトリである場合、このメソッドは再帰的に動作し、ディレクトリに含まれるすべてのファイルとサブディレクトリの所有権を取得します。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 TakeOwnerShipEx(
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
パラメーター
-
StopFileName [out]
-
TakeOwnerShipEx メソッドが失敗したファイルまたはディレクトリの名前。 メソッドが成功した場合、このパラメーターは NULL です 。
-
StartFileName [in, optional]
-
TakeOwnerShipEx の開始点として使用する子ファイルまたはディレクトリに名前を付けます。 StartFileName パラメーターは、通常、前のメソッド呼び出しでエラーが発生したファイルまたはディレクトリを指定する StopFileName パラメーターです。 このパラメーターが NULL の場合、 ExecMethod 呼び出しで指定されたファイルまたはディレクトリに対して操作が実行されます。
StartFileName を使用する場合は、Recursive も true に設定する必要があります。
-
Recursive [in, optional]
-
True の場合、所有権の変更は、CIM_LogicalFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリに再帰的に適用されます。
注意
ファイル インスタンスの場合、 Recursive 入力パラメーターは無視されます。
戻り値
成功した場合は 0 (ゼロ) の整数値を返し、エラーを示すその他の数値を返します。
-
0
-
要求は成功しました。
-
2
-
アクセスが拒否されました。
-
8
-
指定されていないエラーが発生しました。
-
9
-
指定された名前が無効です。
-
"10"
-
指定されたオブジェクトは既に存在します。
-
11
-
このファイル システムは NTFS ではありません。
-
12
-
プラットフォームは Windows ではありません。
-
13
-
ドライブは同じではありません。
-
14
-
ディレクトリが空ではありません。
-
15
-
共有違反が発生しました。
-
16
-
指定された開始ファイルが無効です。
-
17
-
操作に必要な特権は保持されません。
-
21
-
指定されたパラメーターが無効です。
例
次の 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] |
|