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

StartFileName を使用する場合は、Recursive も true に設定する必要があります。

Recursive [in]

TRUE の場合、メソッドは 、CIM_DataFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリにも再帰的に適用されます。 ファイル インスタンスの場合、このパラメーターは無視されます。

戻り値

成功した場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。 その他のエラー コードについては、「 WMI エラー定数」 または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

0

正常終了しました。

2

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

8

指定されていないエラー。

9

オブジェクトが無効です。

10

オブジェクトは既にあります。

11

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

12

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

13

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

14

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

15

共有違反です。

16

開始ファイルが無効です。

17

特権が保持されていません。

21

無効なパラメーター。

注釈

CIM_DataFileの CopyEx メソッドは WMI によって実装されます。

このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。

要件

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

こちらもご覧ください

CIM_DataFile

WMI タスク: ファイルとフォルダー

ファイルとディレクトリのアクセス権の定数