IOpcPartSet::Metode CreatePart (msopc.h)

Artikel
02/29/2024

Membuat objek bagian yang mewakili bagian dan menambahkan penunjuk ke antarmuka IOpcPart objek ke set.

Sintaks

HRESULT CreatePart(
  [in]          IOpcPartUri             *name,
  [in]          LPCWSTR                 contentType,
  [in]          OPC_COMPRESSION_OPTIONS compressionOptions,
  [out, retval] IOpcPart                **part
);

Parameter

[in] name

Penunjuk ke antarmuka IOpcPartUri dari objek URI bagian yang mewakili nama bagian dari bagian tersebut.

Untuk membuat objek URI bagian (yang mengimplementasikan antarmuka IOpcPartUri ) untuk mewakili nama bagian bagian, panggil metode IOpcFactory::CreatePartUri .

[in] contentType

Tipe media isi bagian.

[in] compressionOptions

Nilai yang menjelaskan cara untuk memadatkan konten bagian dari bagian tersebut.

[out, retval] part

Penunjuk ke IOpcPart baru yang mewakili bagian .

Parameter ini tidak boleh NULL.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Mengembalikan kode/nilai	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Parameter nama adalah NULL.
E_INVALIDARG	Nilai yang diteruskan dalam parameter compressionOptions bukan nilai enumerasi OPC_COMPRESSION_OPTIONS yang valid.
OPC_E_DUPLICATE_PART 0x8051000B	Bagian dengan nama bagian yang ditentukan sudah ada dalam paket saat ini.
OPC_E_INVALID_CONTENT_TYPE 0x80510044	Tipe konten tidak sesuai dengan aturan untuk jenis media yang valid, yang ditentukan dalam RFC 2616: HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html) dan OPC.
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	Jenis konten bagian yang berbeda dari jenis konten yang diharapkan (ditentukan dalam OPC, ECMA-376 Bagian 2), atau konten bagian tidak cocok dengan jenis konten bagian.
Kesalahan Konsumsi Paket	Kode kesalahan HRESULT dari Grup Kesalahan Konsumsi Paket.
Kesalahan URI bagian	Kode kesalahan HRESULT dari Grup Kesalahan URI Bagian.

Keterangan

Ketika objek bagian dibuat dan penunjuk ke dalamnya ditambahkan ke set, bagian yang diwakilinya diserialisasikan ketika paket diserialisasikan.

Metode ini tidak dapat membuat objek bagian yang mewakili bagian Hubungan.

Jika konten bagian dikompresi sebelum pembuatan objek bagian, teruskan nilai OPC_COMPRESSION_NONE dalam parameter compressionOptions .

Konten bagian yang sudah dikompresi tidak akan memadatkan secara signifikan lebih banyak.

IOpcPart menyediakan akses ke properti bagian. Untuk detail tentang properti ini, lihat Gambaran Umum Bagian dan topik IOpcPart .

Keamanan Thread

Objek pengemasan tidak aman untuk utas.

Untuk informasi selengkapnya, lihat Memulai PACKAGING API.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	msopc.h