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

패키지 종속성의 사용자 범위입니다. NULL인 경우 호출자의 사용자 컨텍스트가 사용됩니다. 옵션 매개 변수에 대해 ScopeIsSystem 지정된 경우 NULL이어야 합니다.

packageFamilyName

형식: PCWSTR

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

minVersion

형식: PACKAGE_VERSION

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

packageDependencyProcessorArchitectures

형식: PackageDependencyProcessorArchitectures

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

lifetimeKind

형식: PackageDependencyLifetimeKind

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

lifetimeArtifact

형식: PCWSTR

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

options

형식: CreatePackageDependencyOptions

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

packageDependencyId

형식: PWSTR*

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

반환 값

형식: HRESULT

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

비고

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

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

요구 사항