Bagikan melalui

Metode IAppxBundleWriter::AddPayloadPackage (appxpackaging.h)

  • Artikel

Menambahkan paket aplikasi baru ke bundel.

Sintaks

HRESULT AddPayloadPackage(
  [in] LPCWSTR fileName,
  [in] IStream *packageStream
);

Parameter

[in] fileName

Jenis: LPCWSTR

Nama file payload. Jalur nama file harus relatif terhadap akar paket.

[in] packageStream

Jenis: IStream*

IStream yang menyediakan konten fileName. Aliran harus mendukung Baca, Cari, dan Stat.

Nilai kembali

Jenis: HRESULT

Jika metode berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan akan menampilkan kode kesalahan yang mencakup, tetapi tidak terbatas pada kode kesalahan dalam tabel berikut. Kode OPC kesalahan, selain OPC_E_DUPLICATE_PART dapat mengakibatkan. Jika metode gagal, penulis bundel akan menutup dalam keadaan gagal dan tidak dapat digunakan lagi.

Menampilkan kode Deskripsi
E_NOT_VALID_STATE
Penulis ditutup.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
 Nama file yang ditentukan bukan nama file yang valid atau merupakan nama yang dicadangkan untuk file jejak.
OPC_E_DUPLICATE_PART
 Nama file yang ditentukan sudah digunakan dalam bundel.

Keterangan

Ketika metode AddPayloadFile berhasil konten fileName yang ditentukan ditulis ke paket dan entri yang sesuai dibuat dalam peta blok paket.

AddPayloadPackage membaca konten paket aplikasi dari packageStream dan menyimpan konten dalam bundel dengan fileName yang diberikan.

AddPayloadPackage dapat gagal jika:

  • packageStream tidak mengirimkan paket aplikasi yang valid
  • Paket aplikasi yang dikirimkan oleh packageStream berada dalam keluarga paket yang berbeda dari paket aplikasi yang sudah ditambahkan ke bundel
  • Paket aplikasi yang dikirimkan oleh packageStream ditargetkan ke arsitektur yang tidak dapat berada di bundel yang sama dengan paket aplikasi lain yang sudah ditambahkan ke bundel
  • Paket aplikasi yang dikirimkan oleh packageStream memiliki peta blok yang menggunakan metode hash yang berbeda dari paket aplikasi yang sudah ditambahkan ke bundel
  • fileName bukan nama file yang valid, adalah nama yang dipesan, atau sudah digunakan oleh paket aplikasi lain yang ditambahkan ke bundel

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform Windows
Header appxpackaging.h

Lihat juga

IAppxBundleWriter