Metode IXpsOMObjectFactory1::CreatePackageWriterOnFile1 (xpsobjectmodel_1.h)

Artikel
03/13/2024

Membuka file untuk menulis konten XPS OM ke paket XPS dari jenis tertentu. Metode ini menghasilkan penulis paket untuk dokumen MSXPS atau dokumen OpenXPS.

Sintaks

HRESULT CreatePackageWriterOnFile1(
  LPCWSTR                   fileName,
  LPSECURITY_ATTRIBUTES     securityAttributes,
  DWORD                     flagsAndAttributes,
  BOOL                      optimizeMarkupSize,
  XPS_INTERLEAVING          interleaving,
  IOpcPartUri               *documentSequencePartName,
  IXpsOMCoreProperties      *coreProperties,
  IXpsOMImageResource       *packageThumbnail,
  IXpsOMPrintTicketResource *documentSequencePrintTicket,
  IOpcPartUri               *discardControlPartName,
  XPS_DOCUMENT_TYPE         documentType,
  IXpsOMPackageWriter       **packageWriter
);

Parameter

fileName

[in] Nama file yang akan dibuat.

securityAttributes

[in, unik] Struktur SECURITY_ATTRIBUTES , yang berisi dua anggota terpisah tetapi terkait:

lpSecurityDescriptor: pendeskripsi keamanan opsional
bInheritHandle: nilai Boolean yang menentukan apakah handel yang dikembalikan dapat diwariskan oleh proses anak

Jika lpSecurityDescriptor adalah NULL, file atau perangkat yang terkait dengan handel yang dikembalikan diberi pendeskripsi keamanan default.

Untuk informasi selengkapnya tentang securityAttributes, lihat CreateFile.

flagsAndAttributes

[in] Menentukan pengaturan dan atribut file yang akan dibuat. Untuk sebagian besar file, nilai FILE_ATTRIBUTE_NORMAL dapat digunakan.

Lihat CreateFile untuk informasi selengkapnya tentang parameter ini.

optimizeMarkupSize

[in] Nilai Boolean yang menunjukkan apakah markup dokumen akan dioptimalkan untuk ukuran ketika konten OM XPS ditulis ke paket XPS.

Nilai	Makna
BENAR	Penulis paket akan mencoba mengoptimalkan markup untuk ukuran minimum.
SALAH	Penulis paket tidak akan mencoba melakukan pengoptimalan apa pun.

interleaving

[in] Menentukan apakah konten OM XPS akan diselingi ketika ditulis ke file.

documentSequencePartName

[in] Antarmuka IOpcPartUri yang berisi nama bagian urutan dokumen dalam file baru.

coreProperties

[in] Antarmuka IXpsOMCoreProperties yang berisi properti dokumen inti yang akan diberikan ke file baru. Parameter ini dapat diatur ke NULL.

packageThumbnail

[in] Antarmuka IXpsOMImageResource yang berisi gambar mini yang akan ditetapkan ke file baru. Parameter ini dapat diatur ke NULL.

documentSequencePrintTicket

[in] Antarmuka IXpsOMPrintTicketResource yang berisi tiket cetak tingkat paket yang akan ditetapkan ke file baru. Parameter ini dapat diatur ke NULL.

discardControlPartName

[in] Antarmuka IOpcPartUri yang berisi nama bagian kontrol buang. Parameter ini dapat diatur ke NULL.

documentType

[in] Menentukan tipe dokumen penulis paket. Nilai parameter ini tidak boleh XPS_DOCUMENT_TYPE_UNSPECIFIED.

packageWriter

[out, retval] Penunjuk ke antarmuka IXpsOMPackageWriter baru yang dibuat oleh metode ini.

Nilai kembali

Nilai yang mungkin termasuk, tetapi tidak terbatas pada, berikut ini. Untuk informasi tentang nilai pengembalian API dokumen XPS yang tidak tercantum di sini, lihat Kesalahan Dokumen XPS.

S_OK: Metode berhasil dan packageWriter diatur dengan benar.

E_INVALIDARG: Jenis dokumen bukan format dokumen XPS yang valid.

Keterangan

Gunakan metode ini untuk menghasilkan penulis paket untuk dokumen MSXPS atau dokumen OpenXPS. CreatePackageWriterOnFile, dirilis di Windows 7, hanya membuat file dokumen XPS dalam format MSXPS.

Referensi Tambahan

Referensi Tambahan: Deskripsi metode warisan

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	xpsobjectmodel_1.h
Pustaka	Tidak ada

Lihat juga

IXpsOMObjectFactory1

Bagikan melalui