IXtfFileIOClient::CopyFiles メソッド
開発コンソール上の 2 つの場所間でファイルをコピーし、操作に関する情報を返します。構文
パラメーター
pszSearchPattern型: LPCWSTR コピー元のファイル名を定義する検索パターンへのポインター。このパラメーターは、指定したパターンに文字列を一致させるためのワイルドカード文字を受け付けます。 dwIncludeAttributes
型: DWORD コピーに含めるファイル属性のビット単位 OR の組み合わせ。指定可能な属性の一覧については、File Attribute Constants を参照してください。 dwExcludeAttributes
型: DWORD コピーから除外するファイル属性のビット単位 OR の組み合わせ。指定可能な属性の一覧については、File Attribute Constants を参照してください。 dwRecursionLevels
型: DWORD コピー時に再帰処理するディレクトリの階層数。ディレクトリ ツリー全体を対象にする場合は -1 を指定します。 pszDstFileName
型: LPCWSTR コピー先のファイル名へのポインター。 dwFlags
型: DWORD ファイルのコピー方法を指定するフラグ。次の表に示すマクロのビット単位 OR の組み合わせです。
pCallback
型: IXtfCopyFileCallback* コピーのステータスが変化したときに呼び出す IXtfCopyFileCallback コールバックへのポインター。
戻り値
型: HRESULT 成功した場合はS_OK を返します。それ以外の場合は HRESULT のエラー コードを返します。
解説
IXtfFileIOClient::CopyFiles は、XBOX コンソール上のある場所から別の場所に 1 つまたは複数のファイルをコピーする処理を開始します。ファイル コピー コマンドの進行状況を追跡するには、IXtfCopyFileCallback のインスタンスを使用してコールバック関数を定義します。IXtfCopyFileCallback には、ファイル コピー操作の開始時、進行中、および完了時に呼び出されるコールバック関数が含まれています。ワイルドカード文字を使用して複数のファイルをコピーする場合、pszDstFileName パラメーターはディレクトリと見なされ、コピーされたすべてのファイルがそのディレクトリに配置されます。ディレクトリが存在しない場合は、ファイルがコピーされる前に作成されます。 dwIncludeAttributes および dwExcludeAttributes パラメーターは、どのファイルをコピーするかを示すフィルターとして機能します。これらのパラメーターは、ファイルをコピーする際にどのファイル属性がコピーされるかを示すフィルターとしては機能しません。
要件
ヘッダー: xtffileio.h ライブラリ: xtffileio.lib 対応プラットフォーム: Windows (XBOX コンソール ツール用)関連項目
IXtfFileIOClient インターフェイスXtfFileIO