DownloadOperation.AttachAsync 메서드

참조

정의

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

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

편집

연결된 다운로드의 진행률 및 완료를 모니터링하는 데 사용할 수 있는 비동기 작업을 반환합니다. 이 메서드를 호출하면 앱이 이전 앱 instance 시작된 다운로드 작업을 연결할 수 있습니다.

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 가 반환되면 throw됩니다.

이는 네트워킹 메서드에서 throw되는 가장 일반적인 예외입니다. 앱은 예외의 HRESULT 를 사용하여 오류의 원인을 확인해야 합니다.

AccessDeniedException

리소스 또는 기능에 대한 액세스가 거부된 경우 throw됩니다. 이 예외는 앱에 요청된 네트워크 작업에 대한 앱 매니페스트에 설정된 필수 네트워크 기능이 없는 경우에 발생합니다.

InvalidArgumentException

메서드에 제공된 인수 중 하나가 유효하지 않을 때 throw됩니다.

사용자가 제공한 입력으로 인해 이 예외가 발생한 경우 앱이 사용자에게 알리고 새 입력을 요청할 수 있습니다.

ObjectDisposedException

삭제된 개체에서 연산이 수행될 때 throw됩니다.

OutOfMemoryException

메모리가 부족하여 작업을 완료할 수 있을 때 throw됩니다.

이 메서드는 여러 앱 인스턴스에서 호출할 수 있지만 개발자는 백그라운드 작업에서 instance 기본 앱의 콜백을 연결해서는 안 됩니다. 이로 인해 BackgroundTransferHost.exe 중단됩니다.

적용 대상

다음을 통해 공유