TryCreatePackageDependency 함수(appmodel.h)

지정된 패키지 패밀리 이름, 최소 버전 및 추가 조건을 사용하여 현재 앱에 대한 프레임워크 패키지 종속성에 대한 설치 시간 참조를 만듭니다.

구문

HRESULT TryCreatePackageDependency(
  PSID                                    user,
  PCWSTR                                  packageFamilyName,
  PACKAGE_VERSION                         minVersion,
  PackageDependencyProcessorArchitectures packageDependencyProcessorArchitectures,
  PackageDependencyLifetimeKind           lifetimeKind,
  PCWSTR                                  lifetimeArtifact,
  CreatePackageDependencyOptions          options,
  PWSTR                                   *packageDependencyId
);

매개 변수

user

형식: PSID

패키지 종속성의 사용자 scope. NULL이면 호출자의 사용자 컨텍스트가 사용됩니다. CreatePackageDependencyOptions_ScopeIsSystem 지정된 경우 NULL이어야 합니다.

packageFamilyName

형식: PCWSTR

종속성을 사용할 프레임워크 패키지의 패키지 패밀리 이름입니다.

minVersion

형식: PACKAGE_VERSION

종속성을 취할 프레임워크 패키지의 최소 버전입니다.

packageDependencyProcessorArchitectures

형식: PackageDependencyProcessorArchitectures

패키지 종속성의 프로세서 아키텍처입니다.

lifetimeKind

형식: PackageDependencyLifetimeKind

패키지 종속성의 수명을 정의하는 데 사용할 아티팩트 형식입니다. 자세한 내용은 설명을 참조하세요.

lifetimeArtifact

형식: PCWSTR

패키지 종속성의 수명을 정의하는 데 사용되는 아티팩트 이름입니다. lifetimeKind 매개 변수가 PackageDependencyLifetimeKind_Process 경우 NULL이어야 합니다. 자세한 내용은 설명을 참조하세요.

options

형식: CreatePackageDependencyOptions

패키지 종속성을 만들 때 적용할 옵션입니다.

packageDependencyId

형식: PWSTR*

이 메서드가 반환될 때 에는 새 패키지 종속성의 ID를 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터의 주소가 포함됩니다. 호출자는 HeapFree를 호출하여 더 이상 필요하지 않은 경우 이 리소스를 해제할 책임이 있습니다.

반환 값

형식: HRESULT

함수가 성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 함수는 오류 코드를 반환합니다. 가능한 오류 코드에는 다음이 포함됩니다.

반환 코드	설명
E_INVALIDARG	packageDependencyId 매개 변수는 입력 시 NULL입니다.

설명

앱의 설치 관리자에서 또는 앱을 처음 실행하는 동안 이 메서드를 호출하여 앱에서 사용하려는 프레임워크 패키지에 대한 조건 집합을 지정합니다. 이는 앱에서 지정된 조건을 충족하는 프레임워크 패키지에 종속되어 있음을 OS에 알립니다. 조건을 충족하는 하나 이상의 프레임워크 패키지가 설치된 경우 Windows는 설치 시간 참조가 삭제될 때까지 이러한 프레임워크 패키지 중 하나 이상이 설치된 상태로 유지되도록 합니다. 자세한 내용은 동적 종속성 API를 사용하여 런타임에 MSIX 패키지 참조를 참조하세요.

지정된 종속성 조건을 특정 패키지로 확인할 수 없는 경우 이 함수는 실패합니다. options 매개 변수에 대해 CreatePackageDependencyOptions_DoNotVerifyDependencyResolution 지정한 경우 이 패키지 확인 검사 건너뜁습니다. 이는 대상 사용자 이외의 사용자 컨텍스트로 실행되는 설치 관리자(예: LocalSystem으로 실행되는 설치 관리자)에 유용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 11(10.0.22000.0에 도입)
머리글	appmodel.h

추가 정보

동적 종속성 API를 사용하여 런타임에 MSIX 패키지 참조