TryCreatePackageDependency 函式 （appmodel.h）

使用指定的套件系列名稱、最低版本和其他準則，為目前應用程式的架構套件相依性建立安裝時間參考。

語法

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

參數

user

類型： PSID

套件相依性的使用者範圍。 如果為 Null，則會使用呼叫端的使用者內容。 如果指定 CreatePackageDependencyOptions_ScopeIsSystem ，則必須為 Null。

packageFamilyName

類型： PCWSTR

要依賴之架構套件的套件系列名稱。

minVersion

類型： PACKAGE_VERSION

要依賴的架構套件的最低版本。

packageDependencyProcessorArchitectures

類型： PackageDependencyProcessorArchitectures

套件相依性的處理器架構。

lifetimeKind

類型： PackageDependencyLifetimeKind

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

lifetimeArtifact

類型： PCWSTR

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

options

類型： CreatePackageDependencyOptions

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

packageDependencyId

類型： PWSTR*

當這個方法傳回時，包含指向以 Null 結尾的 Unicode 字串的指標位址，以指定新套件相依性的識別碼。 呼叫端負責在呼叫 HeapFree 之後，在不再需要此資源時釋放此資源。

返回值

類型： HRESULT

如果函式成功，則會傳回 ERROR_SUCCESS。 否則，函式會傳回錯誤碼。 可能的錯誤代碼包括以下內容。

備註

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

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

需求

另請參閱

使用動態相依性 API 在執行階段參考 MSIX 套件