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，則會使用呼叫端的用戶內容。 如果為 options 參數指定 ScopeIsSystem，則必須為 NULL。

packageFamilyName

類型： PCWSTR

要採用相依性之架構套件的套件系列名稱。

minVersion

類型： PACKAGE_VERSION

要採用相依性之架構套件的最低版本。

packageDependencyProcessorArchitectures

類型： PackageDependencyProcessorArchitectures

封裝相依性處理器架構。

lifetimeKind

類型： PackageDependencyLifetimeKind

要用來定義封裝相依性存留期的成品類型。 如需詳細資訊，請參閱備註。

lifetimeArtifact

類型： PCWSTR

用來定義封裝相依性存留期的成品名稱。 如果 lifetimeKind 參數為 Process，則必須為 NULL。 如需詳細資訊，請參閱備註。

options

類型： CreatePackageDependencyOptions

建立套件相依性時要套用的選項。

packageDependencyId

類型： PWSTR*

新套件相依性標識碼。 使用 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