다음을 통해 공유


IAsyncInfo 인터페이스

정의

비동기 작업 및 작업을 지원합니다. IAsyncInfo는 IAsyncAction , IAsyncActionWithProgressTProgress, IAsyncOperation 대한 기본 인터페이스입니다. TResultIAsyncOperationWithProgressTResult, TProgress각각은 비동기 메서드에 대한 반환 형식 및 진행률 조합을 지원합니다.

public interface class IAsyncInfo
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(54, 0, 0, 192, 0, 0, 0, 0, 0, 0, 70)]
struct IAsyncInfo
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(54, 0, 0, 192, 0, 0, 0, 0, 0, 0, 70)]
public interface IAsyncInfo
Public Interface IAsyncInfo
파생
특성

Windows 요구 사항

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

설명

IAsyncInfo는 비동기 메서드 지원에 사용되는 4개의 Windows 런타임 인터페이스 각각에 대한 상속된 인터페이스입니다. 다음과 같습니다.

앱 코드에서 비동기 메서드를 사용하는 경우 일반적으로 이러한 인터페이스는 반환 값으로 표시되지 않습니다. 이는 인터페이스를 내부적으로 처리하는 언어별 대기 가능 구문을 거의 항상 사용하기 때문입니다. 자세한 내용은 비동기 프로그래밍또는 Windows 런타임 비동기 프로그래밍에 대한 언어별 가이드 중 하나를 참조하세요(C# 또는 Visual Basic, C++, JavaScript).

대부분의 앱 코드에서는 대기 가능한 구문을 사용하지 않더라도 IAsyncInfo를 API로 사용하는 것은 드문 일입니다. 각 언어에는 일반적으로 Windows RuntimeIAsyncInfo 인터페이스보다 사용하기 쉬운 확장 지점이 있습니다. JavaScript에는 다음/완료 구문이 있습니다. .NET에는 AsTask 확장 메서드가 있으며 IAsyncAction작업변환되면 취소하고 완료 시 알림을 받는 것이 더 쉽습니다. C++/CX의 경우 동시성 런타임사용하여 호출을 래핑할 수 있습니다. 즉, IAsyncInfo는 런타임 수준 인프라이며, 각 언어는 자체적으로 대기 가능한 구문을 지원하기 위해 프레임워크로 사용합니다.

사용자 지정 작업 또는 사용자 지정 작업(고급 시나리오)을 구현하는 경우 IAsyncAction 직접 구현하지 않습니다. 대신 이전에 나열된 4개의 인터페이스 중 하나를 구현합니다.

속성

ErrorCode

비동기 작업의 오류 조건을 설명하는 문자열을 가져옵니다.

Id

비동기 작업의 핸들을 가져옵니다.

Status

비동기 작업의 상태를 나타내는 값을 가져옵니다.

메서드

Cancel()

비동기 작업을 취소합니다.

Close()

비동기 작업을 닫습니다.

적용 대상

추가 정보