IXtfFileIOClient::CopyFiles メソッド
開発機本体上の 2 つの場所の間でファイルをコピーし、操作についての情報を返します。
構文
public:
HRESULT CopyFiles(
LPCWSTR pszSearchPattern,
DWORD dwIncludeAttributes,
DWORD dwExcludeAttributes,
DWORD dwRecursionLevels,
LPCWSTR pszDstFileName,
DWORD dwFlags,
IXtfCopyFileCallback *pCallback
)
パラメーター
pszSearchPattern
型: LPCWSTR
コピーするソース ファイルのファイル名を定義する検索パターンへのポインター。 このパラメーターは、指定されたパターンの文字列に一致するワイルドカード文字を受け入れます。
dwIncludeAttributes
型: DWORD
コピーに含めるファイル属性のビット単位 OR の組み合わせ。 使用可能な属性の一覧については、「ファイル属性定数」を参照してください。
dwExcludeAttributes
型: DWORD
コピーから除外するファイル属性のビット単位 OR の組み合わせ。 使用可能な属性の一覧については、「ファイル属性定数」を参照してください。
dwRecursionLevels
型: DWORD
コピーで再帰的に検索するディレクトリ階層数。-1 は、ディレクトリ ツリーのすべてのレベルをカバーします。
pszDstFileName
型: LPCWSTR
コピー先のターゲット ファイルのファイル名へのポインター。
dwFlags
型: DWORD
ファイルをコピーする方法を指定するフラグ。 これは、次の表に示したマクロをビットごとの OR と組み合わせた値です。
| 値 | マクロ | 説明 |
|---|---|---|
| 0x80000000 | XTFCOPYFILE_DEFER | ファイルのコピーを延期します。 |
pCallback
型: IXtfCopyFileCallback*
コピーの状態が変化したときに呼び出す IXtfCopyFileCallback コールバックへのポインター。
戻り値
型: HRESULT
正常に実行された場合は S_OK を返し、失敗した場合は HRESULT エラー コードを返します。
解説
IXtfFileIOClient::CopyFiles は、1 つまたは複数のファイルを Xbox 本体上のある場所から別の場所にコピーするプロセスを開始します。 ファイル コピー コマンドの進行状況を追跡するには、IXtfCopyFileCallback のインスタンスを使用してコールバック関数を定義します。
IXtfCopyFileCallback には、ファイル コピー操作の開始時、進行中、および完了後に呼び出されるコールバック関数が含まれています。
ワイルドカード文字を使用して複数のファイルをコピーする場合は、pszDstFileName パラメーターがディレクトリであると見なされ、すべてのコピーされたファイルがそのディレクトリに配置されます。 ディレクトリが存在しない場合は、ファイルがコピーされる前に作成されます。
dwIncludeAttributes と dwExcludeAttributes パラメーターは、コピーするファイルを示すフィルターとして機能します。 これらのパラメーターは、ファイルをコピーするときにコピーされるファイル属性を示すフィルターとしては機能しません。
要件
ヘッダー: xtffileio.h
ライブラリ: xtffileio.lib
サポートされているプラットフォーム: Windows (Xbox 本体ツール用)