Metode IAppxPackageWriter::AddPayloadFile (appxpackaging.h)

Artikel
03/14/2023

Menambahkan file payload baru ke paket aplikasi.

Sintaks

HRESULT AddPayloadFile(
  [in] LPCWSTR                 fileName,
  [in] LPCWSTR                 contentType,
  [in] APPX_COMPRESSION_OPTION compressionOption,
  [in] IStream                 *inputStream
);

Parameter

[in] fileName

Jenis: LPCWSTR

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

[in] contentType

Jenis: LPCWSTR

String yang menentukan jenis kontenfileName.

[in] compressionOption

Jenis: APPX_COMPRESSION_OPTION

Jenis kompresi yang digunakan untuk menyimpan fileName dalam paket.

[in] inputStream

Jenis: IStream*

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

Mengembalikan nilai

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 paket akan menutup dalam keadaan gagal dan tidak dapat digunakan lagi.

Menampilkan kode	Deskripsi
E_INVALIDARG	Opsi kompresi yang ditentukan oleh compressionOption bukan salah satu nilai enumerasi APPX_COMPRESSION_OPTION .
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 paket.

Keterangan

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

Catatan File dengan nama file cadangan berikut tidak dapat ditambahkan ke paket menggunakan metode AddPayloadFile :

AppxManifest.xml, AppxBlockMap.xml, AppxStreamMap.xml, dan AppxSignature.p7x.

Selain itu, file dengan awalan folder yang dipesan berikut tidak dapat ditambahkan ke paket menggunakan metode AddPayloadFile : \AppxMetadata\ dan \Microsoft.System.Package.Metadata\.

Contoh

Misalnya, lihat Cara membuat paket aplikasi.

Persyaratan


Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	appxpackaging.h

Lihat juga

APPX_COMPRESSION_OPTION

IAppxPackageWriter

Bagikan melalui