Win32_Directory クラスの Copy メソッド

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

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

構文

uint32 Copy(
   string FileName
);

パラメーター

FileName

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

戻り値

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

0

要求は成功しました。

2

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

8

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

9

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

"10"

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

11

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

12

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

13

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

14

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

15

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

16

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

17

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

21

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

注釈

フォルダーは、多くの場合、ある場所から別の場所にコピーする必要があります。 たとえば、あるサーバーから別のサーバーにフォルダーをコピーして、そのフォルダーのバックアップ コピーを作成できます。 または、ユーザー ワークステーションにコピーする必要があるテンプレート フォルダーや、すべての DNS サーバーにコピーする必要がある scripts フォルダーがある場合があります。

Win32_Directory Copy メソッドを使用すると、同じコンピューター (ドライブ C からドライブ D へのフォルダーのコピーなど) またはリモート コンピューター上で、ある場所から別の場所にフォルダーをコピーできます。 フォルダーをコピーするには、コピーするフォルダーのインスタンスを返し、Copy メソッドを呼び出し、パラメーターとしてフォルダーの新しいコピーのターゲットの場所を渡します。 たとえば、次のコード行は、ドライブ F の Scripts フォルダーにフォルダーをコピーします。

objFolder.Copy("F:\Scripts")

COPY メソッドを実行しても、WMI は既存のフォルダーを上書きしません。 つまり、コピー先フォルダーが存在する場合、コピー操作は失敗します。 たとえば、Scripts という名前のフォルダーがあり、そのフォルダーを \\atl-fs-01\archive という名前のリモート共有にコピーしようとするとします。 その共有に Scripts という名前のフォルダーが既に存在する場合、コピー操作は失敗します。

例

WMI を使用してフォルダーをコピーするから取得した次のコード サンプルでは、Copy メソッドを使用してフォルダー C:\Scripts を D:\Archive にコピーします。

strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set colFolders = objWMIService.ExecQuery( _ 
    "Select * from Win32_Directory where Name = 'c:\\Scripts'") 
 
For Each objFolder in colFolders 
    errResults  = objFolder.Copy("D:\Archive") 
Next

要件

こちらもご覧ください

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

Win32_Directory