IXpsOMPackageWriter::AddResource method (xpsobjectmodel.h)

Artikel
03/15/2023

Membuat sumber daya bagian baru dalam paket.

Sintaks

HRESULT AddResource(
  [in] IXpsOMResource *resource
);

Parameter

[in] resource

Antarmuka IXpsOMResource dari sumber daya bagian yang akan ditambahkan sebagai bagian baru dalam paket. Lihat Keterangan untuk jenis sumber daya yang mungkin diteruskan dalam parameter ini.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk informasi tentang nilai pengembalian API dokumen XPS yang tidak tercantum dalam tabel ini, lihat Kesalahan Dokumen XPS.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Sumber daya dengan nama yang sama dengan sumber daya yang dirujuk oleh sumber daya telah ditambahkan ke aliran atau tidak ada hubungan yang menyertakan sumber daya yang dirujuk oleh sumber daya. Setelah E_INVALIDARG dikembalikan, aliran atau file tidak lagi valid dan Tutup akan mengembalikan XPS_E_UNAVAILABLE_PACKAGE.
XPS_E_UNAVAILABLE_PACKAGE	Terjadi kesalahan parah dan isi OM XPS mungkin tidak dapat dipulihkan. Beberapa komponen XPS OM mungkin masih dapat digunakan tetapi hanya setelah diverifikasi. Karena status XPS OM tidak dapat diprediksi setelah kesalahan ini dikembalikan, semua komponen OM XPS harus dirilis dan dibuang.

Metode ini memanggil PACKAGING API. Untuk informasi tentang nilai pengembalian PACKAGING API, lihat Kesalahan Pengemasan.

Keterangan

Metode ini membuat bagian baru dalam paket dokumen yang sesuai dengan sumber daya, menambahkan konten sumber daya ke bagian baru, lalu menutup bagian baru.

Jika metode ini mengembalikan kesalahan, penulis paket tidak lagi dapat digunakan.

Parameter sumber daya harus salah satu dari berikut ini:

Antarmuka IXpsOMFontResource dari sumber daya font yang digunakan di halaman saat ini atau halaman yang telah ditambahkan.
Antarmuka IXpsOMImageResource dari sumber daya gambar yang digunakan di halaman saat ini atau halaman yang telah ditambahkan.
Antarmuka IXpsOMColorProfileResource sumber daya profil warna yang digunakan di halaman saat ini atau halaman yang telah ditambahkan.
Antarmuka IXpsOMStoryFragmentsResource dari sumber daya fragmen cerita yang digunakan di halaman saat ini atau halaman yang telah ditambahkan.
Antarmuka IXpsOMDocumentStructureResource dari sumber daya struktur dokumen yang digunakan dalam dokumen saat ini atau dokumen yang telah ditambahkan.
Antarmuka IXpsOMSignatureBlockResource dari sumber daya blok tanda tangan yang digunakan dalam dokumen saat ini atau dokumen yang telah ditambahkan.

Metode ini mengembalikan kesalahan jika sumber daya berisi salah satu hal berikut:

Antarmuka IXpsOMRemoteDictionaryResource dari kamus sumber daya jarak jauh.
Antarmuka IXpsOMPrintTicketResource dari tiket cetak.
Antarmuka IXpsOMImageResource dari gambar mini.

Metode ini mengembalikan kesalahan ketika sumber daya mereferensikan sumber daya yang memiliki nama yang sama dengan sumber daya yang telah ditambahkan ke aliran atau yang tidak ada hubungan yang ada.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	xpsobjectmodel.h