TransferStatus Enumeration

TransferStatus Enumeration

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Defines the list of states that a background transfer request can be.

Namespace:  Microsoft.Phone.BackgroundTransfer
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)

public enum TransferStatus
<object property="enumerationValue" .../>

Member nameDescription
NoneThe request has not yet been queued.
TransferringThe requested file is currently being transferred.
WaitingThe request is waiting in the background transfer service queue. This status can indicate that the request is queued and waiting for previous transfers to complete or that the service is retrying the request due to a network error.
WaitingForWiFiThe request is waiting in the background transfer service queue for a Wi-Fi connection.
WaitingForExternalPowerThe request is waiting in the background transfer service queue for external power to be connected.
WaitingForExternalPowerDueToBatterySaverModeThe request is waiting for the device to be connected to external power because the user has enabled Battery Saver mode on the device.
WaitingForNonVoiceBlockingNetworkThe background transfer service does not run when the device is on a non-simultaneous voice and data network, including 2G, EDGE, and standard GPRS. This status indicates the service is waiting for a supported network connection.
PausedThe request has been paused and waiting in the background transfer service queue.
CompletedThe request has completed. This means that the request is no longer actionable by the background transfer service regardless of whether the transfer was completed successfully. To confirm that a transfer was successful, confirm that the TransferError property is null.
UnknownThe background transfer service could not retrieve the request status from the service. Once in this state, a BackgroundTransferRequest object is no longer useable. You may attempt to retrieve a new instance using the Find(String) method.

Access transfer status information using the TransferStatus property of the BackgroundTransferRequest class. To receive updates when the status of a transfer request changes, implement a handler for the TransferStatusChanged event.


If you use this API in your app, you must specify the following capabilities in the app manifest. Otherwise, your app might not work correctly or it might exit unexpectedly.


Windows Phone 8, Windows Phone OS 7.1

For more info, see App capabilities and hardware requirements for Windows Phone 8.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1

Windows Phone

© 2017 Microsoft