PackageTransferManager.TransferStatus Property

Contains the status of the current transfer.

Syntax

public:
property PackageTransferStatus TransferStatus {
         PackageTransferStatus get ();
}  

Property value

Type: PackageTransferStatus 

The transfer status.

Remarks

If your code is monitoring an installation and determines that it has taken too long for a chunk to install, check the PackageTransferManager::TransferStatus value to see if the installation has been stopped, been paused, or encountered an error. If the installer is no longer in the Running or Paused state, then you should take action to mitigate this for the user.

You should examine the TransferStatus property once per frame at most. Ideally, you should check it only in response to a chunk taking longer than your title expects or to the user trying to initiate an action they cannot perform until the chunk is present.

Network installations and download times can vary considerably, so applying a simple timeout may lead to false failures. If you have a watchdog for chunk installation and TransferStatus returns Running, you should continue waiting for the chunk and handle the delay in your title code. Do not assume that it has failed.

See the System Behavior When Title Installation Fails (Developer Education Materials > All NDA Whitepapers) white paper on the White Papers XGD page for additional information.

Requirements

Namespace: Windows.Xbox.Management.Deployment

Metadata: windows.winmd

See also

Reference

PackageTransferManager Class

PackageTransferManager Members

Windows.Xbox.Management.Deployment Namespace