RegisterPackageAsync 메서드

PackageManager.RegisterPackageAsync Method

현재 사용자에 대한 패키지(기본 패키지)와 관련 종속성 패키지를 등록합니다.

구문


public IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> RegisterPackageAsync(
  Uri manifestUri, 
  IEnumerable<Uri> dependencyPackageUris, 
  DeploymentOptions deploymentOptions
)

매개 변수

manifestUri

형식: System.Uri [.NET] | Windows::Foundation::Uri [C++]

기본 패키지의 패키지 매니페스트 경로입니다.

dependencyPackageUris

형식: IIterable<Uri> [C++] | System.Collections.Generic.IEnumerable<Uri> [.NET]

종속성 패키지의 경로입니다. 종속성 패키지가 없거나 종속성 패키지가 이미 등록된 경우 이 매개 변수는 null일 수 있습니다. DeploymentOptionsDevelopmentMode로 설정된 경우 이 매개 변수는 null이어야 합니다.

deploymentOptions

형식: DeploymentOptions

열거형 값 중 하나입니다.

반환 값

형식: IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress>

배포 요청 상태입니다. DeploymentResult는 배포 작업이 완료된 후 배포 작업의 마지막 반환 값을 포함합니다. DeploymentProgress는 배포 작업 전체 과정에 대한 완료 백분율을 가져오는 데 사용할 수 있습니다.

설명

등록 작업은 패키지 매니페스트가 네트워크 경로가 아닌 로컬 컴퓨터에 있는 경우에만 실행될 수 있습니다. 또한 DevelopmentMode 옵션으로 패키지를 등록하지 않는 한 패키지 페이로드가 디스크의 %ProgramFiles%\WindowsApps에 준비되어 있어야 합니다. PackageManager.StagePackageAsync를 사용하여 패키지를 디스크에 준비할 수 있습니다.

SYSTEM에서는 이 API를 호출할 수 없습니다.

동일한 패키지 패밀리 이름을 사용하는 패키지가 이미 설치되어 있거나 DeploymentOptions 값 중 하나를 사용하여 컴퓨터의 한 사용자에 대해 등록된 경우 DevelopmentMode 옵션으로 패키지를 등록하려고 하면 오류가 반환됩니다. 또한 DevelopmentMode 패키지는 컴퓨터당 한 명의 사용자에 대해서만 설치할 수 있습니다. 두 번째 사용자가 패키지 패밀리 이름이 같은 다른 DevelopmentMode 패키지를 등록하려고 할 경우 오류가 발생합니다. DevelopmentMode에서 패키지를 등록하는 동안 오류가 발생할 경우 컴퓨터에 모든 다른 사용자를 위해 설치된 패키지 또는 DevelopmentMode 패키지(동일한 패키지 패밀리 이름 사용)를 제거해야 할지 여부를 확인합니다.

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

Namespace

Windows.Management.Deployment
Windows::Management::Deployment [C++]

Metadata

Windows.winmd

참고 항목

PackageManager

 

 

표시:
© 2016 Microsoft