CIM_DeviceFile クラスの CopyEx メソッド
CopyEx メソッドは、オブジェクト パスで指定された論理デバイス ファイル (またはディレクトリ) を FileName パラメーターで指定された場所にコピーします。 既存の論理ファイルを上書きする必要がある場合、コピーはサポートされません。 このメソッドは、 Copy メソッドの拡張バージョンです。 このメソッドは、 CIM_LogicalFileから継承されます。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 CopyEx(
[in] string FileName,
[out] string REF StopFileName,
[in] string StartFileName,
[in] boolean Recursive
);
パラメーター
-
FileName [in]
-
宛先ファイル (またはディレクトリ) の完全修飾名。
例: "c:\temp\newdirectory"
-
StopFileName [out]
-
メソッドが失敗したファイル (またはディレクトリ) の名前を表す文字列。 メソッドが成功した場合、このパラメーターは null です 。
-
StartFileName [in]
-
このメソッドの開始点として使用する子ファイル (またはディレクトリ) を表す文字列。 通常、 StartFileName パラメーターは StopFileName パラメーターで、前のメソッド呼び出しでエラーが発生したファイルまたはディレクトリを指定します。 このパラメーターが null の場合、 ExecMethod 呼び出しで指定されたファイル (またはディレクトリ) に対して操作が実行されます。
-
Recursive [in]
-
TRUE の場合、メソッドは、 CIM_DeviceFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリにも再帰的に適用されます。 ファイル インスタンスの場合、このパラメーターは無視されます。
戻り値
成功した場合は 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] |
|