CIM_Directory クラスの CopyEx メソッド
CopyEx メソッドは、オブジェクト パスで指定された論理ファイル (またはディレクトリ) を FileName パラメーターで指定された場所にコピーします。 このメソッドは Copy メソッドの拡張バージョンであり、 CIM_LogicalFileから継承されます。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 CopyEx(
[in] string REF FileName,
[out] string StopFileName,
[in] string StartFileName,
[in] boolean Recursive
);
パラメーター
-
FileName [in]
-
コピー先ファイル (またはディレクトリ) のコピーの完全修飾名。
例: "c:\temp\newdirectory"
-
StopFileName [out]
-
メソッドが失敗したファイル (またはディレクトリ) の名前を表す文字列。 メソッドが成功した場合、このパラメーターは null です 。
-
StartFileName [in]
-
このメソッドの開始点として使用する子ファイル (またはディレクトリ) を表す文字列。 通常、このパラメーターは、前のメソッド呼び出しからエラーが発生したファイルまたはディレクトリを指定する StopFileName パラメーターです。 このパラメーターが null の場合、 ExecMethod 呼び出しで指定されたファイル (またはディレクトリ) に対して操作が実行されます。
-
Recursive [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 ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|