MddBootstrapInitialize 関数 (mddbootstrap.h)

  • [アーティクル]

呼び出し元プロセスを初期化して、指定した条件に最も一致するWindows アプリ SDK フレームワーク パッケージのバージョンを使用します。 この関数は、外部の場所でパッケージ化されているか、パッケージ化されていないデスクトップ アプリで使用することを目的としています。

MddBootstrapInitialize2 は、 MddBootstrapInitialize よりも使いやすさとトラブルシューティングの改善を提供します。

「 定数」も参照してください。

構文

HRESULT MddBootstrapInitialize(
  UINT32          majorMinorVersion,
  PCWSTR          versionTag,
  PACKAGE_VERSION minVersion
);

パラメーター

majorMinorVersion

種類: UINT32

読み込むWindows アプリ SDK製品のメジャー バージョンとマイナー バージョン (1.2 など)。 これは、一致する 正確な メジャーバージョンとマイナーバージョンです。最小値ではありません。

majorMinorVersion は として 0xMMMMNNNNエンコードされます。ここで M 、 = Major および N = Minor (たとえば、バージョン 1.2 は として 0x00010002エンコードされます)。

versionTag

種類: PCWSTR

読み込むWindows アプリ SDK フレームワーク パッケージのバージョン タグ (存在する場合)。 たとえば、「 "prerelease" 」のように入力します。

minVersion

種類: PACKAGE_VERSION

使用するWindows アプリ SDKランタイム パッケージの最小バージョン (majorMinorVersion にも一致します)。

このバージョン (0.319.455 など) は、Windows アプリ SDK リリース バージョン (1.0.2 など) と製品バージョン (1.0 など) とは異なります。

Windows アプリ SDKランタイム バージョンの値は、C++ ヘッダーWindowsAppSDK-VersionInfo.hから取得できます。詳細については、「例」を参照してください。

戻り値

種類: HRESULT

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

注釈

エラーはすべて EventLog の アプリケーション チャネルに記録されます。

パラメーターに互換性がある場合は、この関数を複数回呼び出すことができます。 最初の呼び出しでは、 フレームワーク パッケージを解決する作業が行われます。以降の呼び出しは、パラメーターが最初の呼び出しによって解決された フレームワーク パッケージと互換性がある場合、no-op です。 後続の呼び出しのパラメーターに互換性がない場合、API は失敗し、エラーを返します。

この関数は、指定した条件を満たし、パッケージを現在のプロセスで使用できるようにするWindows アプリ SDKフレームワーク パッケージを検索します。 複数のパッケージが条件を満たしている場合、この関数は最適な候補を選択します。

ブートストラップ コンポーネントがWindows アプリ SDKを適切に初期化し、ランタイム参照をフレームワーク パッケージに追加できるようにするために、他のWindows アプリ SDK API を呼び出す前に、起動時にこの関数を呼び出す必要があります。

動的依存関係有効期間マネージャー (DDLM) もこの関数の初期化の対象となります。 DDLM は、パッケージ化されていないアプリで使用されている間に、オペレーティング システム (OS) がWindows アプリ SDK フレームワーク パッケージにサービスを提供できないようにするためのインフラストラクチャを提供します。

「外部の場所またはパッケージ化されていないアプリにWindows アプリ SDK ランタイムを使用する」も参照してください。

注意

この関数を呼び出す前に、COM を現在のスレッド用に初期化する必要があります。

注意

この API がパッケージ化されていないアプリで成功するには、Windows アプリ SDK パッケージをデバイスにインストールする必要があります (「チュートリアル: 外部の場所でパッケージ化されたアプリでブートストラップ API を使用する」または「Windows アプリ SDKを使用するパッケージ化されていないアプリでブートストラップ API を使用する」を参照してください)。

例

MddBootstrapInitialize2 の例を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 10 Version 1809 (Windows アプリ SDK 1.0 以降)
Header mddbootstrap.h
Library Microsoft.WindowsAppRuntime.Bootstrap.lib
[DLL] Microsoft.WindowsAppRuntime.Bootstrap.dll

こちらもご覧ください