BG_FILE_PROGRESS 構造体 (bits.h)

  • [アーティクル]

転送されたバイト数など、ファイル関連の進行状況情報を提供します。

構文

typedef struct _BG_FILE_PROGRESS {
  UINT64 BytesTotal;
  UINT64 BytesTransferred;
  BOOL   Completed;
} BG_FILE_PROGRESS;

メンバー

BytesTotal

ファイルのサイズ (バイト単位)。 BITS がファイルのサイズを判別できない場合 (ファイルまたはサーバーが存在しない場合など)、値はBG_SIZE_UNKNOWN。

ファイルから範囲をダウンロードする場合、 BytesTotal には、ファイルからダウンロードする合計バイト数が反映されます。

BytesTransferred

転送されたバイト数。

Completed

ダウンロードの場合、ユーザーがファイルを使用できる場合、値は TRUE になります。それ以外の場合、値は FALSE です。 ファイルは、 IBackgroundCopyJob::Complete メソッドを呼び出した後にユーザーが使用できます。 Complete メソッドで一時的なエラーが発生した場合は、エラーが発生する前に処理されたファイルをユーザーが使用できます。他の人はではありません。 Complete メンバーを使用して、Complete が失敗したときにユーザーがファイルを使用できるかどうかを判断します。

アップロードの場合、ファイルのアップロードが完了すると、値は TRUE になります。それ以外の場合、値は FALSE です。

注釈

BITS によってファイルが転送されたかどうかを確認するには、次の手順を実行します。

URL のタイム スタンプが変更された場合、進行状況の値は 0 に戻されることに注意してください。

要件

要件 値
サポートされている最小のクライアント Windows XP
サポートされている最小のサーバー Windows Server 2003
Header bits.h

こちらもご覧ください

BG_JOB_PROGRESS

BG_JOB_REPLY_PROGRESS

IBackgroundCopyFile::GetProgress

IBackgroundCopyJob3::AddFileWithRanges