PackageDependency.CreateForSystem メソッド

定義

名前空間:

Microsoft.Windows.ApplicationModel.DynamicDependency

指定したパッケージ ファミリ名と最小バージョンと指定したオプションを使用して、現在のアプリのフレームワーク パッケージ依存関係のインストール時参照を作成します。 このメソッドは、すべてのユーザーがアクセスできるフレームワーク パッケージの依存関係を作成します。このメソッドでは、呼び出し元に管理者権限が必要です。 現在のユーザーのみがアクセスできるフレームワーク パッケージの依存関係を作成するには、代わりに Create メソッドを使用します。

public:
 static PackageDependency ^ CreateForSystem(Platform::String ^ packageFamilyName, PackageVersion minVersion, CreatePackageDependencyOptions ^ options);

 static PackageDependency CreateForSystem(winrt::hstring const& packageFamilyName, PackageVersion const& minVersion, CreatePackageDependencyOptions const& options);

public static PackageDependency CreateForSystem(string packageFamilyName, PackageVersion minVersion, CreatePackageDependencyOptions options);

function createForSystem(packageFamilyName, minVersion, options)

Public Shared Function CreateForSystem (packageFamilyName As String, minVersion As PackageVersion, options As CreatePackageDependencyOptions) As PackageDependency

パラメーター

packageFamilyName

String

Platform::String

winrt::hstring

依存関係を取得するフレームワーク パッケージのパッケージ ファミリ名。

minVersion

PackageVersion

依存関係を取得するフレームワーク パッケージの最小バージョン。

options

CreatePackageDependencyOptions

アプリで使用するフレームワーク パッケージを指定するための追加の条件を定義します。

戻り値

PackageDependency

パッケージの依存関係を表し、依存関係の有効期間を管理するために使用できるメンバーを提供する オブジェクト。

注釈

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

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

こちらもご覧ください

• 動的依存関係 API を使用して、実行時に MSIX パッケージを参照する