IXtfCopyFileCallback::OnFileCopyProgress Method
ファイル コピーの進行状況が変化したときに呼び出されます。構文
パラメーター
pszSrcFileName型: LPCWSTR ソース ファイルのファイル名へのポインターです。このパラメーターは非推奨となっており、現在は pszDstFileName のコピーが値として設定されます。 pszDstFileName
型: LPCWSTR コピー先ファイルのファイル名へのポインターです。 ullFileSize
型: ULONGLONG ソース ファイルの合計サイズ (バイト単位) です。 ullBytesCopied
型: ULONGLONG これまでにコピーされたファイルのバイト数です。
戻り値
型: HRESULT 成功した場合はS_OK を返します。それ以外の場合は HRESULT エラー コードを返します。
解説
この関数は、ファイル コピー操作中に転送されるパケットごとに IXtfFileIOClient::CopyFiles メソッドによって呼び出されます。あるファイルに対する IXtfCopyFileCallback::OnFileCopyProgress の最初の呼び出しでは、ullBytesCopied に 0 バイト、ullFileSize に MAX_FILE_SIZE バイトが指定されます。この最初の呼び出しは、新しいファイルのコピーが開始されたことを示します。以降の IXtfCopyFileCallback::OnFileCopyProgress の呼び出しで指定されるファイル情報を使用して、ファイル コピー操作中の進行状況を追跡および表示できます。このコールバック関数が HRESULT エラー コードを返した場合、ファイル コピー操作は中止されます。
要件
ヘッダー: xtffileio.h ライブラリ: xtffileio.lib サポートされるプラットフォーム: Windows (XBOX コンソール ツール用)関連項目
IXtfCopyFileCallback InterfaceXtfFileIO