MddTryCreatePackageDependency 함수(msixdynamicdependency.h)

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

구문

HRESULT MddTryCreatePackageDependency(
  PSID                                       user,
  PCWSTR                                     packageFamilyName,
  PACKAGE_VERSION                            minVersion,
  MddPackageDependencyProcessorArchitectures packageDependencyProcessorArchitectures,
  MddPackageDependencyLifetimeKind           lifetimeKind,
  PCWSTR                                     lifetimeArtifact,
  MddCreatePackageDependencyOptions          options,
  PWSTR                                      *packageDependencyId
) noexcept;

매개 변수

user

형식: PSID

사용자가 패키지 종속성을 scope. NULL인 경우 호출자의 사용자 컨텍스트가 사용됩니다. Options 매개 변수에 ScopeIsSystem이 지정된 경우 NULL이어야 합니다.

packageFamilyName

형식: PCWSTR

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

minVersion

형식: PACKAGE_VERSION

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

packageDependencyProcessorArchitectures

형식: PackageDependencyProcessorArchitectures

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

lifetimeKind

형식: PackageDependencyLifetimeKind

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

lifetimeArtifact

형식: PCWSTR

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

options

형식: CreatePackageDependencyOptions

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

packageDependencyId

형식: PWSTR*

새 패키지 종속성의 ID입니다. HeapAlloc 함수를 사용하여 이 매개 변수에 대한 메모리를 할당하고 HeapFree를 사용하여 메모리 할당을 취소합니다.

반환 값

형식: HRESULT

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

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

설명

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

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 1809(Windows 앱 SDK 1.0 이상 포함)
머리글	msixdynamicdependency.h