Fungsi GetPackagePathByFullName2 (appmodel.h)

  • Artikel

Mendapatkan jalur paket yang ditentukan, dengan opsi untuk menentukan jenis jalur folder yang akan diambil untuk paket.

Sintaks

LONG GetPackagePathByFullName2(
  PCWSTR          packageFullName,
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Parameter

packageFullName

Jenis: PCWSTR

Nama lengkap paket.

packagePathType

Jenis: PackagePathType

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

pathLength

Jenis: UINT32*

Pointer ke variabel yang menyimpan jumlah karakter (WCHARs) dalam string jalur paket, yang mencakup null-terminator.

Pertama Anda meneruskan NULL ke jalur untuk mendapatkan jumlah karakter. Anda menggunakan nomor ini untuk mengalokasikan ruang memori untuk jalur. Kemudian Anda meneruskan alamat ruang memori ini untuk mengisi jalur.

path

Jenis: PWSTR

Pointer ke ruang memori yang menerima string jalur paket, yang mencakup null-terminator.

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
ERROR_INSUFFICIENT_BUFFER
 Buffer yang ditentukan oleh jalur tidak cukup besar untuk menyimpan data. Ukuran yang diperlukan ditentukan oleh pathLength.

Keterangan

Parameter packagePathType berguna untuk aplikasi yang menggunakan ekstensi windows.mutablePackageDirectories dalam manifes paketnya. 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 KernelBase.dll

Lihat juga

GetPackagePathByFullName