Skip to main content

IXtfCopyFileCallback::OnStartFileCopy Method

開発コンソール上の 2 つの場所間でのファイルのコピーが開始されるときに呼び出されます。

構文

パラメーター

pszRootDirectory
型: LPCWSTR
コピーのルート ディレクトリ パスへのポインターです。 pszSearchPattern
型: LPCWSTR
コピー対象となるソース ファイルのファイル名を定義する検索パターンへのポインターです。このパラメーターはワイルドカード文字を受け付け、指定したパターンで文字列を照合します。 pSrcFileInfo
型: LPCXTFFILEINFO
コピーされたファイルに関する情報を含む XTFFILEINFO 構造体へのポインターです。 pszDstFileName
型: LPCWSTR
コピー先ファイルのファイル名へのポインターです。

戻り値

型: HRESULT 成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

解説

このコールバック関数は、ファイル コピー操作の開始時に IXtfFileIOClient::CopyFiles メソッドによって 1 回呼び出されます。XTFFILEINFO 構造体で返されるファイル サイズは、コピーする必要のあるファイル群のサイズの合計 (バイト単位) を表します。この合計を使用して、ファイル コピー操作全体の進行状況を追跡できます。このコールバック関数が HRESULT エラー コードを返した場合、ファイル コピー操作は中止されます。

要件

ヘッダー: xtffileio.h ライブラリ: xtffileio.lib サポートされるプラットフォーム: Windows (XBOX コンソール ツール用)

関連項目

IXtfCopyFileCallback Interface
XtfFileIO
最終更新日 2026年8月24日