Fungsi MddTryCreatePackageDependency (msixdynamicdependency.h)

Artikel
04/27/2023

Membuat referensi waktu penginstalan untuk dependensi paket kerangka kerja untuk aplikasi saat ini, menggunakan nama keluarga paket yang ditentukan, versi minimum, dan kriteria tambahan.

Sintaks

HRESULT MddTryCreatePackageDependency(
  PSID                                       user,
  PCWSTR                                     packageFamilyName,
  PACKAGE_VERSION                            minVersion,
  MddPackageDependencyProcessorArchitectures packageDependencyProcessorArchitectures,
  MddPackageDependencyLifetimeKind           lifetimeKind,
  PCWSTR                                     lifetimeArtifact,
  MddCreatePackageDependencyOptions          options,
  PWSTR                                      *packageDependencyId
) noexcept;

Parameter

user

Jenis: PSID

Cakupan pengguna dependensi paket. Jika NULL, konteks pengguna pemanggil digunakan. Harus NULL jika ScopeIsSystem ditentukan untuk parameter opsi .

packageFamilyName

Jenis: PCWSTR

Nama keluarga paket paket kerangka kerja untuk mengambil dependensi.

minVersion

Jenis: PACKAGE_VERSION

Versi minimum paket kerangka kerja untuk mengambil dependensi.

packageDependencyProcessorArchitectures

Jenis: PackageDependencyProcessorArchitectures

Arsitektur prosesor dependensi paket.

lifetimeKind

Jenis: PackageDependencyLifetimeKind

Jenis artefak yang digunakan untuk menentukan masa pakai dependensi paket. Untuk informasi selengkapnya, lihat keterangan.

lifetimeArtifact

Jenis: PCWSTR

Nama artefak yang digunakan untuk menentukan masa pakai dependensi paket. Harus NULL jika parameter lifetimeKind adalah Proses. Untuk informasi selengkapnya, lihat keterangan.

options

Jenis: CreatePackageDependencyOptions

Opsi untuk diterapkan saat membuat dependensi paket.

packageDependencyId

Jenis: PWSTR*

ID dependensi paket baru. Gunakan fungsi HeapAlloc untuk mengalokasikan memori untuk parameter ini, dan gunakan HeapFree untuk membatalkan alokasi memori.

Nilai kembali

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS. Jika tidak, fungsi mengembalikan kode kesalahan. Kode kesalahan yang mungkin mencakup yang berikut ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Parameter packageDependencyId adalah NULL pada input.

Keterangan

Di alat penginstal aplikasi Anda atau selama eksekusi pertama aplikasi Anda, panggil metode ini untuk menentukan serangkaian kriteria untuk paket kerangka kerja yang ingin Anda gunakan di aplikasi Anda. Ini menginformasikan OS bahwa aplikasi Anda memiliki dependensi pada paket kerangka kerja yang memenuhi kriteria yang ditentukan. Jika satu atau beberapa paket kerangka kerja diinstal yang memenuhi kriteria, Windows akan memastikan bahwa setidaknya salah satu paket kerangka kerja ini akan tetap diinstal sampai referensi waktu penginstalan dihapus. Untuk informasi selengkapnya, lihat Menggunakan API dependensi dinamis untuk mereferensikan paket MSIX pada durasi.

Fungsi ini gagal jika kriteria dependensi yang ditentukan tidak dapat diselesaikan ke paket tertentu. Pemeriksaan resolusi paket ini dilewati jika DoNotVerifyDependencyResolution ditentukan untuk parameter opsi . Ini berguna untuk alat penginstal yang berjalan sebagai konteks pengguna selain pengguna target (misalnya, penginstal yang berjalan sebagai LocalSystem).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1809 (dengan SDK Aplikasi Windows 1.0 atau yang lebih baru)
Header	msixdynamicdependency.h

Bagikan melalui