CIM_DataFile クラスの TakeOwnerShipEx メソッド
TakeOwnerShipEx メソッドは、オブジェクト パスで指定された論理データ ファイルの所有権を取得します。 このメソッドは TakeOwnerShip メソッドの拡張バージョンであり、 CIM_LogicalFileから継承されます。 論理ファイルがディレクトリの場合、このメソッドは再帰的に動作し、ディレクトリに含まれるすべてのファイルとサブディレクトリの所有権を取得します。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 TakeOwnerShipEx(
[out] string StopFileName,
[in] string StartFileName,
[in] boolean Recursive
);
パラメーター
-
StopFileName [out]
-
メソッドが失敗したファイル (またはディレクトリ) の名前。 メソッドが成功した場合、このパラメーターは null になります。
-
StartFileName [in]
-
このメソッドの開始点として使用する子ファイル (またはディレクトリ)。 通常、 StartFileName パラメーターは、前のメソッド呼び出しでエラーが発生したファイル (またはディレクトリ) を指定する StopFileName パラメーターです。 このパラメーターが null の場合、 ExecMethod 呼び出しで指定されたファイル (またはディレクトリ) に対して操作が実行されます。
StartFileName を使用する場合は、Recursive も true に設定する必要があります。
-
Recursive [in]
-
TRUE の場合、メソッドは、CIM_DataFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリにも再帰的に適用されます。 ファイル インスタンスの場合、このパラメーターは無視されます。
戻り値
成功した場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。 その他のエラー コードについては、「 WMI エラー定数 」または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。
-
0
-
成功しました。
-
2
-
アクセスが拒否されました。
-
8
-
未指定のエラー。
-
9
-
オブジェクトが無効です。
-
"10"
-
オブジェクトは既にあります。
-
11
-
ファイル システムは NTFS ではありません。
-
12
-
Windows ではなくプラットフォーム。
-
13
-
ドライブは同じではありません。
-
14
-
ディレクトリは空ではありません。
-
15
-
共有違反です。
-
16
-
開始ファイルが無効です。
-
17
-
特権が保持されていません。
-
21
-
無効なパラメーター。
注釈
CIM_DataFileの TakeOwnerShipEx メソッドは WMI によって実装されます。
このドキュメントは、DMTF によって公開されている CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーを修正したり、Microsoft SDK ドキュメントの標準に準拠したり、詳細情報を提供したりするために変更を加えた可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|