Win32_Directory クラスの CopyEx メソッド

CopyExWMI クラス メソッドは、オブジェクト パスで指定された論理ディレクトリ エントリ ファイルまたはディレクトリを FileName パラメーターで指定された場所にコピーします。 このメソッドは、 Copy メソッドの拡張バージョンです。 既存の論理ファイルを上書きする必要がある場合、コピーはサポートされません。

このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。

構文

uint32 CopyEx(
  [in]           string  FileName,
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

パラメーター

FileName [in]

ファイル (またはディレクトリ) のコピーの完全修飾名。 例: c:\temp\newdirectory。

StopFileName [out]

CopyEx メソッドが失敗したファイルまたはディレクトリの名前。 メソッドが成功した場合、このパラメーターは null になります 。

StartFileName [in, optional]

CopyEx の開始点として使用する子ファイルまたはディレクトリに名前を 付けます。 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

指定されたパラメーターが無効です。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

こちらもご覧ください

オペレーティング システム クラス

Win32_Directory