BG_FILE_PROGRESS構造体
BG_FILE_PROGRESS構造体は、転送されたバイト数などのファイル関連の進行状況情報を提供します。
構文
typedef struct _BG_FILE_PROGRESS {
UINT64 BytesTotal;
UINT64 BytesTransferred;
BOOL Completed;
} BG_FILE_PROGRESS;
メンバー
-
BytesTotal
-
ファイルのサイズ (バイト単位)。 配信の最適化でファイルのサイズを特定できない場合 (たとえば、ファイルまたはサーバーが存在しない場合)、値はDO_UNKNOWN_FILE_SIZE。
ファイルから範囲をダウンロードする場合、 BytesTotal には、ファイルからダウンロードする合計バイト数が反映されます。
-
BytesTransferred
-
転送されたバイト数。
-
Completed
-
ダウンロードの場合、ファイルがユーザーが使用できる場合、値は TRUE です。それ以外の場合、値は FALSE です。 IBackgroundCopyJob::Complete メソッドを呼び出した後、ユーザーがファイルを使用できます。 Complete メソッドで一時的なエラーが生成された場合は、エラーが発生する前に処理されたファイルをユーザーが使用できます。他の人はではありません。 Complete メンバーを使用して、Complete が失敗したときにユーザーがファイルを使用できるかどうかを判断します。
解説
配信の最適化によってファイルが転送されたかどうかを判断するには、次の操作を行います。
- BytesTransferred を BytesTotal と比較します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 10、バージョン 1709 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server バージョン 1709 [デスクトップ アプリのみ] |
| ヘッダー |
|