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 參數是 Process，則必須為 NULL。 如需詳細資訊，請參閱備註。

options

類型：CreatePackageDependencyOptions

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

packageDependencyId

類型：PWSTR*

新套件相依性標識碼。 使用 HeapAlloc 函式來配置此參數的記憶體，並使用 HeapFree 來解除分配記憶體。

返回值

類型：HRESULT

如果函式成功，則會傳回 ERROR_SUCCESS。 否則，函式會傳回錯誤碼。 可能的錯誤碼包括下列專案。

備註

在應用程式的安裝程式中，或在應用程式第一次執行期間，呼叫這個方法，為您想要在應用程式中使用的架構套件指定一組準則。 這會通知 OS 您的應用程式相依於符合指定準則的架構套件。 如果已安裝符合準則的一或多個架構套件，Windows 將確保至少一個這些架構套件會持續安裝，直到刪除安裝時間參考為止。 如需詳細資訊，請參閱 使用動態相依性 API 在執行時間參考 MSIX 套件。

如果指定的相依性準則無法解析為特定套件，則此函式會失敗。 如果 DoNotVerifyDependencyResolution 為 選項指定了 參數，則會略過此套件解析檢查。 這對於以目標使用者以外的使用者內容執行的安裝程式很有用（例如，以 LocalSystem 身分執行的安裝程式）。

需求