DownloadOperation.AttachAsync メソッド

リファレンス

定義

名前空間:: Windows.Networking.BackgroundTransfer

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

アタッチされたダウンロードの進行状況と完了を監視するために使用できる非同期操作を返します。このメソッドを呼び出すと、アプリは、前のアプリインスタンスで開始されたダウンロード操作をアタッチできます。

public:
 virtual IAsyncOperationWithProgress<DownloadOperation ^, DownloadOperation ^> ^ AttachAsync() = AttachAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DownloadOperation, DownloadOperation const&> AttachAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DownloadOperation,DownloadOperation> AttachAsync();

function attachAsync()

Public Function AttachAsync () As IAsyncOperationWithProgress(Of DownloadOperation, DownloadOperation)

戻り値

IAsyncOperationWithProgress<DownloadOperation,DownloadOperation>

コールバックを使用したダウンロード操作。

属性: RemoteAsyncAttribute

例

function AttachDownload (loadedDownload) {
    try {
        download = loadedDownload;
        promise = download.attachAsync().then(complete, error, progress);
    } catch (err) {
        displayException(err);
    }
};

注釈

例外

COMException

機能固有の HRESULT がメソッド呼び出しから返されるときにスローされます。

これは、ネットワークメソッドによってスローされる最も一般的な例外です。アプリでは、例外の HRESULT を使用してエラーの原因を特定する必要があります。

AccessDeniedException

リソースや機能へのアクセスが拒否されるとスローされます。この例外は、要求されたネットワーク操作に必要なネットワーク機能がアプリマニフェストに設定されていない場合に発生します。

InvalidArgumentException

メソッドに提供された引数のいずれかが有効でない場合にスローされます。

ユーザーが指定した入力によってこの例外が発生した場合、アプリはユーザーに通知し、新しい入力を要求できます。

ObjectDisposedException

破棄されたオブジェクトで操作が実行されるとスローされます。

OutOfMemoryException

操作を完了するために十分なメモリが使用できない場合にスローされます。

このメソッドは複数のアプリインスタンスから呼び出すことができますが、開発者はバックグラウンドタスクでプライマリアプリインスタンスからのコールバックをアタッチしないでください。これにより、 BackgroundTransferHost.exe がハングします。

適用対象