Fungsi GetCurrentPackageInfo2 (appmodel.h)

Artikel
02/23/2024

Mendapatkan informasi paket untuk proses panggilan, dengan opsi untuk menentukan jenis jalur folder yang akan diambil untuk paket.

Sintaks

LONG GetCurrentPackageInfo2(
  const UINT32    flags,
  PackagePathType packagePathType,
  UINT32          *bufferLength,
  BYTE            *buffer,
  UINT32          *count
);

Parameter

flags

Jenis: const UINT32

Konstanta paket yang menentukan bagaimana informasi paket diambil. Bendera PACKAGE_FILTER_* didukung.

packagePathType

Jenis: PackagePathType

Menunjukkan jenis jalur folder yang akan diambil untuk paket (folder penginstalan asli atau folder yang dapat diubah).

bufferLength

Jenis: UINT32*

Pada input, ukuran buffer, dalam byte. Pada output, ukuran array struktur yang dikembalikan, dalam byte.

buffer

Jenis: BYTE*

Informasi paket, direpresentasikan sebagai array struktur PACKAGE_INFO .

count

Jenis: UINT32*

Jumlah struktur dalam buffer.

Nilai kembali

Jenis: LONG

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
APPMODEL_ERROR_NO_PACKAGE	Proses ini tidak memiliki identitas paket.
ERROR_INSUFFICIENT_BUFFER	Buffer tidak cukup besar untuk menyimpan data. Ukuran yang diperlukan ditentukan oleh bufferLength.

Keterangan

Parameter packagePathType berguna untuk aplikasi yang menggunakan ekstensi windows.mutablePackageDirectories dalam manifes paket mereka. Ekstensi ini menentukan folder di bawah jalur %ProgramFiles%\ModifiableWindowsApps tempat konten folder penginstalan aplikasi diproyeksikan sehingga pengguna dapat mengubah file penginstalan. Fitur ini saat ini hanya tersedia untuk jenis game PC desktop tertentu yang diterbitkan oleh Microsoft dan mitra kami, dan memungkinkan jenis game ini untuk mendukung mod.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	appmodel.h
Pustaka	Kernel32.lib
DLL	Kernel32.dll