Win32_CodecFile クラスの 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 呼び出しで指定されたファイルまたはディレクトリに対して操作が実行されます。

Recursive [in, optional]

true の場合、所有権の変更は、CIM_LogicalFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリに再帰的に適用されます。

注意

ファイル インスタンスの場合、 Recursive 入力パラメーターは無視されます。

戻り値

ファイルが正常にコピーされた場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。

0

要求は成功しました。

2

アクセスが拒否されました。

8

未指定のエラーが発生しました。

9

指定された名前が無効でした。

"10"

指定されたオブジェクトは既に存在します。

11

このファイル システムは NTFS ではありません。

12

プラットフォームは Windows ではありません。

13

ドライブは同じではありません。

14

ディレクトリが空ではありません。

15

共有違反が発生しました。

16

指定された開始ファイルが無効でした。

17

操作に必要な特権は保持されません。

21

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

要件

こちらもご覧ください

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

Win32_CodecFile