MddAddPackageDependency 関数 (msixdynamicdependency.h)

[アーティクル]
09/08/2023

指定したオプションを使用して MddTryCreatePackageDependency メソッドを使用して、前に作成したフレームワークパッケージ依存関係のランタイム参照を追加します。このメソッドが正常に返された後、アプリは型をアクティブ化し、フレームワークパッケージのコンテンツを使用できます。

構文

HRESULT MddAddPackageDependency(
  PCWSTR                         packageDependencyId,
  INT32                          rank,
  MddAddPackageDependencyOptions options,
  MDD_PACKAGEDEPENDENCY_CONTEXT  *packageDependencyContext,
  PWSTR                          *packageFullName
) noexcept;

パラメーター

packageDependencyId

種類: PCWSTR

解決され、呼び出し元プロセスのパッケージグラフに追加されるパッケージ依存関係の ID。このパラメーターは、呼び出し元のユーザーまたはシステムに対して TryCreatePackageDependency 関数を使用して定義されたパッケージの依存関係と一致する必要があります ( ScopeIsSystem オプションを使用)。

rank

種類: INT32

解決されたパッケージを呼び出し元のパッケージグラフに追加するために使用するランク。詳細については、備考を参照してください。

options

種類: MddAddPackageDependencyOptions

パッケージの依存関係を追加するときに適用するオプション。

packageDependencyContext

種類: PACKAGEDEPENDENCY_CONTEXT*

追加されたパッケージ依存関係のハンドル。このハンドルは、 RemovePackageDependency に渡されるまで有効です。

packageFullName

種類: PCWSTR*

依存関係が解決されたパッケージの完全な名前。 HeapAlloc 関数を使用してこのパラメーターのメモリを割り当て、HeapFree を使用してメモリの割り当てを解除します。

戻り値

種類: HRESULT

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

リターンコード	説明
E_INVALIDARG	packageDependencyId または packageDependencyContext パラメーターは、入力時に NULL です。

注釈

このメソッドを呼び出すと、フレームワークパッケージの依存関係がシステム上の特定のパッケージに解決されます。また、フレームワークパッケージがアクティブに使用されていること、およびすべてのバージョン更新プログラムをサイドバイサイドで処理することも OS に通知します (アプリの使用が完了するまで、古いバージョンのアンインストールやその他のサービスを実質的に遅らせます)。パッケージ解決はユーザーに固有であり、システム上のさまざまなユーザーに対して異なる値を返すことができます。

MddAddPackageDependency 呼び出しが成功するたびに、既に存在する場合でも、解決されたパッケージが呼び出し元プロセスのパッケージグラフに追加されます。 API によって重複する検出やフィルター処理は適用されません (つまり、パッケージからの複数の参照は有害ではありません)。解決が完了すると、そのユーザーの最後の参照が MddRemovePackageDependency 経由で削除されるか、プロセスが終了するまで、そのユーザーのパッケージ依存関係は解決された状態を維持します。このメソッドの呼び出しが成功すると、 MddGetGenerationId によって返される生成 ID 値が変更されます。

このメソッドが正常に返された後、 MddRemovePackageDependency が呼び出されるまで、アプリは型をアクティブ化し、フレームワークパッケージのコンテンツを使用できます。

MddAddPackageDependency の呼び出しと同じランクを持つパッケージグラフに複数のパッケージが存在する場合、解決されたパッケージは (既定では) 同じランクの他のパッケージの後に追加されます。同じランクの他のユーザーの前にパッケージを追加するには、options パラメーターに PrependIfRankCollision を指定します。

詳細については、「動的依存関係 API を使用して実行時に MSIX パッケージを参照する」を参照してください。