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*

新しいパッケージ依存関係の ID。 HeapAlloc 関数を使用してこのパラメーターのメモリを割り当て、HeapFree を使用してメモリの割り当てを解除します。

戻り値

種類: HRESULT

関数が成功すると、 ERROR_SUCCESSが返されます。 それ以外の場合、関数はエラー コードを返します。 考えられるエラー コードは次のとおりです。

注釈

アプリのインストーラーまたはアプリの初回実行時に、このメソッドを呼び出して、アプリで使用するフレームワーク パッケージの一連の条件を指定します。 これにより、指定された条件を満たすフレームワーク パッケージにアプリが依存していることが OS に通知されます。 条件を満たす 1 つ以上のフレームワーク パッケージがインストールされている場合、Windows では、インストール時参照が削除されるまで、これらのフレームワーク パッケージの少なくとも 1 つはインストールされたままになることが保証されます。 詳細については、「 動的依存関係 API を使用して実行時に MSIX パッケージを参照する」を参照してください。

指定した依存関係条件を特定のパッケージに解決できない場合、この関数は失敗します。 doNotVerifyDependencyResolution が options パラメーターに指定されている場合、このパッケージ解決チェックはスキップされます。 これは、ターゲット ユーザー以外のユーザー コンテキストとして実行されているインストーラー (LocalSystem として実行されているインストーラーなど) に役立ちます。

要件