PackageManager.AddPackageByUriAsync(Uri, AddPackageOptions) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
public:
virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ AddPackageByUriAsync(Uri ^ packageUri, AddPackageOptions ^ options) = AddPackageByUriAsync;/// [Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> AddPackageByUriAsync(Uri const& packageUri, AddPackageOptions const& options);[Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> AddPackageByUriAsync(System.Uri packageUri, AddPackageOptions options);function addPackageByUriAsync(packageUri, options)Public Function AddPackageByUriAsync (packageUri As Uri, options As AddPackageOptions) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)매개 변수
추가할 패키지의 URI입니다. URI는 로컬 파일 경로 및 로컬 네트워크 경로에 파일 URI 스키마(file://)를 사용할 수 있습니다. HTTP 및 HTTPS 프로토콜도 지원됩니다. Windows 빌드 22556부터 URI는 패키지 또는 앱 설치 관리자 파일을 가리킬 수 있습니다.
- options
- AddPackageOptions
작업에 대한 패키지 배포 옵션입니다.
반환
배포 요청의 상태입니다. DeploymentResult에는 완료된 배포 작업의 최종 반환 값이 포함됩니다. DeploymentProgress를 사용하여 배포 작업의 전체 과정에서 완료 비율을 얻을 수 있습니다.
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10, version 2004 (10.0.19041.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v10.0에서 도입되었습니다.)
|
설명
이 메서드는 모든 배포 옵션을 단일 매개 변수로 통합하여 기존 AddPackageAsync 오버로드를 간소화합니다. 이 메서드는 AddPackageAsync 오버로드에서 사용할 수 없는 다음 기능도 지원합니다.
options 매개 변수의 ExternalLocationURI 속성을 사용하여 패키지 매니페스트가 애플리케이션 콘텐츠를 참조할 수 있는 MSIX 패키지 외부에서 외부 디스크 위치의 URI를 지정할 수 있습니다. 이 시나리오 및 관련 코드 샘플에 대한 자세한 내용은 외부 위치로 패키징하여 패키지 ID 부여를 참조하세요.
options 매개 변수의 AllowUnsigned 속성을 사용하여 서명되지 않은 패키지의 실행 파일에서 활성화 정보를 허용할 수 있습니다. 이 시나리오 및 관련 코드 샘플에 대한 자세한 내용은 호스트된 앱을 참조하세요.