BackgroundDownloadProgress 구조체

  • 참조

정의

네임스페이스:
Windows.Networking.BackgroundTransfer
편집

다운로드 작업에 대한 상태 정보를 포함합니다.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
struct BackgroundDownloadProgress
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public struct BackgroundDownloadProgress
var backgroundDownloadProgress = {
bytesReceived : /* Your value */,
totalBytesToReceive : /* Your value */,
status : /* Your value */,
hasResponseChanged : /* Your value */,
hasRestarted : /* Your value */
}
Public Structure BackgroundDownloadProgress
상속
ValueType
BackgroundDownloadProgress
특성
ContractVersionAttribute

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

필드

BytesReceived

받은 총 데이터 바이트 수입니다. 이 값에는 응답 헤더로 수신된 바이트가 포함되지 않습니다. 다운로드 작업을 다시 시작할 수 있습니다(예: 네트워크 중단 후). 작업을 다시 시작하면 이전에 다운로드한 바이트를 삭제해야 할 수 있으므로 다운로드한 바이트 수가 항상 한 보고서에서 다음 보고서로 증가하지는 않을 수 있습니다.
HasResponseChanged

다운로드 요청 응답이 변경된 경우 true입니다. 그렇지 않으면 false입니다.

새 요청이 호출되어 새 응답 정보를 사용할 수 있을 때마다 이 필드는 true로 설정됩니다. 그러면 애플리케이션에서 새 응답 정보를 읽고 필요한 경우 상태를 업데이트하도록 선택할 수 있습니다.
HasRestarted

데이터 전송 작업이 다시 시작되면 true입니다. 그렇지 않으면 false입니다.

다운로드가 중단되고 다운로드를 다시 시작하기 위해 서버에 새 요청이 전송되면 서버가 다시 시작을 지원하지 않고 다운로드를 다시 시작해야 하는 경우 HasRestarted 가 true 로 설정됩니다.

HasRestarted 는 다시 시작 후 전송된 첫 번째 진행률 알림에서만 true 로 설정됩니다. 첫 번째 진행률 알림 후에 HasRestarted 는 이후 알림에서 false 로 설정됩니다.
Status

다운로드 작업의 현재 상태 포함하는 BackgroundTransferStatus입니다.
TotalBytesToReceive

다운로드할 총 데이터 바이트 수입니다. 이 숫자를 알 수 없는 경우 이 값은 0으로 설정됩니다.

적용 대상

추가 정보