IAsyncInfo 인터페이스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
비동기 작업 및 작업을 지원합니다. IAsyncInfo는 IAsyncAction, IAsyncActionWithProgress TProgress<>, IAsyncOperation TResult 및 IAsyncOperationWithProgress<TResult,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 런타임 인터페이스 각각에 대해 상속된 인터페이스입니다. 이러한 방법은 다음과 같습니다.
- IAsyncAction
- IAsyncActionWithProgress<TProgress>
- IAsyncOperation<TResult>
- IAsyncOperationWithProgress<TResult,TProgress>
앱 코드에서 비동기 메서드를 사용하는 경우 일반적으로 이러한 인터페이스는 반환 값으로 표시되지 않습니다. 이는 인터페이스를 내부적으로 처리하는 언어별 대기 가능 구문을 거의 항상 사용하기 때문입니다. 자세한 내용은 비동기 프로그래밍 또는 비동기 프로그래밍을 Windows 런타임 언어별 가이드 중 하나를 참조하세요(C# 또는 Visual Basic, C++, JavaScript에서 비동기 API 호출).
대부분의 앱 코드에서는 대기 가능한 구문을 사용하지 않더라도 IAsyncInfo를 API로 사용하는 것은 드문 일입니다. 각 언어에는 Windows RuntimeIAsyncInfo 인터페이스보다 일반적으로 사용하기 쉬운 확장 지점이 있습니다. JavaScript에는 then/done 구문이 있습니다. .NET에는 AsTask 확장 메서드가 있으며 IAsyncAction 이 작업으로 변환되면 취소하고 완료 시 알림을 받는 등의 작업이 더 쉽습니다. C++/CX의 경우 동시성 런타임을 사용하여 호출을 래핑할 수 있습니다. 즉, IAsyncInfo는 런타임 수준 인프라이며, 각 언어는 자체 방식으로 대기 가능한 구문을 지원하기 위해 프레임워크로 사용합니다.
사용자 지정 작업 또는 사용자 지정 작업(고급 시나리오)을 구현하는 경우 IAsyncAction을 직접 구현하지 않습니다. 이전에 나열된 4개의 인터페이스 중 하나를 대신 구현합니다.
속성
ErrorCode |
비동기 작업의 오류 조건을 설명하는 문자열을 가져옵니다. |
Id |
비동기 작업의 핸들을 가져옵니다. |
Status |
비동기 작업의 상태 나타내는 값을 가져옵니다. |
메서드
Cancel() |
비동기 작업을 취소합니다. |
Close() |
비동기 작업을 닫습니다. |
적용 대상
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기