IXtfCopyFileCallback::OnFileCopyProgress メソッド
ファイルのコピーの進行状況が変化したときに呼び出されます。
構文
public:
HRESULT OnFileCopyProgress(
LPCWSTR pszSrcFileName,
LPCWSTR pszDstFileName,
ULONGLONG ullFileSize,
ULONGLONG ullBytesCopied
)
パラメーター
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 本体ツール用)