CIM_LogicalFile クラスの TakeOwnerShipEx メソッド
TakeOwnerShipEx メソッドは、オブジェクト パスで指定された論理ファイルの所有権を取得します。 このメソッドは 、TakeOwnerShip メソッドの拡張バージョンです。 論理ファイルがディレクトリの場合、このメソッドは再帰的に動作し、ディレクトリに含まれるすべてのファイルとサブディレクトリの所有権を取得します。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 TakeOwnerShipEx(
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
パラメーター
-
StopFileName [out]
-
メソッドが失敗したファイル (またはディレクトリ) の名前を表す文字列。 メソッドが成功した場合、このパラメーターは null です 。
-
StartFileName [in, optional]
-
メソッドの開始点として使用する子ファイル (またはディレクトリ) に名前を付ける文字列。 通常、このパラメーターは StopFileName パラメーターで、前のメソッド呼び出しでエラーが発生したファイルまたはディレクトリを指定します。 このパラメーターが null の場合、 ExecMethod 呼び出しで指定されたファイル (またはディレクトリ) に対して操作が実行されます。
-
Recursive [in, optional]
-
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 |
|
| [DLL] |
|