Bagikan melalui

Fungsi MddBootstrapInitialize2 (mddbootstrap.h)

  • Artikel

Menginisialisasi proses panggilan untuk menggunakan versi paket kerangka kerja SDK Aplikasi Windows yang paling sesuai dengan kriteria yang ditentukan, dengan opsi. Fungsi ini dimaksudkan untuk digunakan oleh aplikasi desktop yang dikemas dengan lokasi eksternal, atau tidak dikemas.

MddBootstrapInitialize2 menawarkan peningkatan kegunaan dan pemecahan masalah melalui MddBootstrapInitialize.

Lihat juga Konstanta.

Sintaks

HRESULT MddBootstrapInitialize2(
  UINT32                        majorMinorVersion,
  PCWSTR                        versionTag,
  PACKAGE_VERSION               minVersion,
  MddBootstrapInitializeOptions options
);

Parameter

majorMinorVersion

Jenis: UINT32

Versi utama dan minor dari produk SDK Aplikasi Windows untuk dimuat (misalnya, 1.2). Ini adalah versi utama dan minor yang tepat untuk dicocokkan; tidak minimum.

majorMinorVersion dikodekan sebagai 0xMMMMNNNN, di mana M = Mayor dan N = Minor (misalnya, versi 1.2 dikodekan sebagai 0x00010002).

versionTag

Jenis: PCWSTR

Tag versi paket kerangka kerja SDK Aplikasi Windows untuk dimuat (jika ada). Contohnya,"prerelease".

minVersion

Jenis: PACKAGE_VERSION

Versi minimum paket runtime SDK Aplikasi Windows (yang juga cocok dengan majorMinorVersion) untuk digunakan.

Versi ini (misalnya, 0.319.455) berbeda dari versi rilis SDK Aplikasi Windows (misalnya, 1.0.2) dan versi produk (misalnya, 1.0).

Nilai versi runtime SDK Aplikasi Windows dapat diperoleh dari header WindowsAppSDK-VersionInfo.hC++, lihat Contoh untuk detail selengkapnya.

options

Jenis: MddBootstrapInitializeOptions

Opsi untuk inisialisasi bootstrapper.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS. Jika tidak, fungsi mengembalikan kode kesalahan.

Keterangan

Kesalahan apa pun dicatat ke saluran Aplikasi EventLog.

Anda dapat memanggil fungsi ini beberapa kali asalkan parameter kompatibel. Panggilan pertama melakukan pekerjaan untuk menyelesaikan paket Kerangka Kerja ; panggilan berikutnya adalah no-op asalkan parameter kompatibel dengan paket Framework yang diselesaikan oleh panggilan pertama. Jika parameter panggilan berikutnya tidak kompatibel, MAKA API gagal dan mengembalikan kesalahan.

Fungsi ini menemukan paket kerangka kerja SDK Aplikasi Windows yang memenuhi kriteria yang ditentukan dan membuat paket tersedia untuk digunakan oleh proses saat ini. Jika beberapa paket memenuhi kriteria, fungsi ini memilih kandidat terbaik.

Fungsi ini harus dipanggil saat startup sebelum memanggil API SDK Aplikasi Windows lainnya untuk memastikan komponen bootstrapper dapat menginisialisasi SDK Aplikasi Windows dengan benar dan menambahkan referensi runtime ke paket kerangka kerja.

Fungsi ini juga menginisialisasi Dynamic Dependency Lifetime Manager (DDLM). DDLM menyediakan infrastruktur untuk mencegah sistem operasi (OS) melayani paket kerangka kerja SDK Aplikasi Windows saat digunakan oleh aplikasi yang tidak dikemas.

Lihat juga Menggunakan runtime SDK Aplikasi Windows untuk aplikasi yang dikemas dengan lokasi eksternal atau tidak dikemas.

Catatan

COM harus diinisialisasi untuk utas saat ini sebelum Anda memanggil fungsi ini.

Catatan

Jika dalam opsi Anda tidak menentukan MddBootstrapInitializeOptions::MddBootstrapInitializeOptions_OnPackageIdentity_NOOP, maka agar API ini berhasil dalam aplikasi yang dikemas dengan lokasi eksternal atau tidak dikemas, paket SDK Aplikasi Windows perlu diinstal pada perangkat (lihat Tutorial: Menggunakan API bootstrapper dalam aplikasi yang dikemas dengan lokasi eksternal atau tidak dikemas yang menggunakan SDK Aplikasi Windows).

Contoh

#include <WindowsAppSDK-VersionInfo.h>
#include <MddBootstrap.h>
// ...

if (FAILED(MddBootstrapInitialize(Microsoft::WindowsAppSDK::Release::MajorMinor, Microsoft::WindowsAppSDK::Release::VersionTag, Microsoft::WindowsAppSDK::Runtime::UInt64))) {
    throw std::exception("Error in Bootstrap initialization");
}

#include <WindowsAppSDK-VersionInfo.h>
#include <MddBootstrap.h>
// ...

HRESULT hr = MddBootstrapInitialize(WINDOWSAPPSDK_RELEASE_MAJORMINOR, WINDOWSAPPSDK_RELEASE_VERSION_TAG_W, WINDOWSAPPSDK_RUNTIME_VERSION_UINT64);
if (FAILED(hr))
{
    wprintf(L"Error 0x%X in Bootstrap initialization\n", hr);
}

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1809 (dengan SDK Aplikasi Windows 1.0 atau yang lebih baru)
Header mddbootstrap.h
Pustaka Microsoft.WindowsAppRuntime.Bootstrap.lib
DLL Microsoft.WindowsAppRuntime.Bootstrap.dll

Lihat juga