Fungsi TryCreatePackageDependency (appmodel.h)

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

Syntax

HRESULT TryCreatePackageDependency(
  PSID                                    user,
  PCWSTR                                  packageFamilyName,
  PACKAGE_VERSION                         minVersion,
  PackageDependencyProcessorArchitectures packageDependencyProcessorArchitectures,
  PackageDependencyLifetimeKind           lifetimeKind,
  PCWSTR                                  lifetimeArtifact,
  CreatePackageDependencyOptions          options,
  PWSTR                                   *packageDependencyId
);

Parameter-parameternya

user

Jenis: PSID

Cakupan pengguna dependensi paket. Jika NULL, konteks pengguna pemanggil digunakan. Harus NULL jika CreatePackageDependencyOptions_ScopeIsSystem ditentukan.

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 komentar.

lifetimeArtifact

Jenis: PCWSTR

Nama artefak yang digunakan untuk menentukan masa pakai dependensi paket. Harus NULL jika parameter lifetimeKindPackageDependencyLifetimeKind_Process. Untuk informasi selengkapnya, lihat komentar.

options

Jenis: CreatePackageDependencyOptions

Opsi yang akan diterapkan saat membuat dependensi paket.

packageDependencyId

Jenis: PWSTR*

Ketika metode ini kembali, berisi alamat penunjuk ke string Unicode yang dihentikan null yang menentukan ID dependensi paket baru. Pemanggil bertanggung jawab untuk membebaskan sumber daya ini setelah tidak lagi diperlukan dengan memanggil HeapFree.

Mengembalikan nilai

Jenis: HRESULT

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

Mengembalikan kode	Description
E_INVALIDARG	Parameter packageDependencyId adalah NULL pada input.

Komentar

Di alat penginstal aplikasi Anda atau selama eksekusi pertama aplikasi, 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 waktu proses.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11 (diperkenalkan pada 10.0.22000.0)
Header	appmodel.h
Library	OneCoreUAP.Lib

Lihat juga

Gunakan API dependensi dinamis untuk mereferensikan paket MSIX pada waktu proses