IXpsOMObjectFactory1::CreatePackageWriterOnStream1-Methode (xpsobjectmodel_1.h)

Artikel
03/05/2024

Öffnet einen Stream zum Schreiben des Inhalts eines XPS OM in ein XPS-Paket eines angegebenen Typs.

Syntax

HRESULT CreatePackageWriterOnStream1(
  ISequentialStream         *outputStream,
  BOOL                      optimizeMarkupSize,
  XPS_INTERLEAVING          interleaving,
  IOpcPartUri               *documentSequencePartName,
  IXpsOMCoreProperties      *coreProperties,
  IXpsOMImageResource       *packageThumbnail,
  IXpsOMPrintTicketResource *documentSequencePrintTicket,
  IOpcPartUri               *discardControlPartName,
  XPS_DOCUMENT_TYPE         documentType,
  IXpsOMPackageWriter       **packageWriter
);

Parameter

outputStream

[in] Der Stream, der zum Schreiben verwendet werden soll.

optimizeMarkupSize

Ein boolescher Wert, der angibt, ob das Dokumentmarkup für die Größe optimiert wird, wenn das Dokument in den Stream geschrieben wird.

Wert	Bedeutung
STIMMT	Beim Schreiben in den Stream versucht der Paketschreiber, das Markup für die Mindestgröße zu optimieren.
FALSE	Beim Schreiben in das Paket versucht der Paketschreiber keine Optimierung.

interleaving

[in] Gibt an, ob der Inhalt des XPS-OM verschachtelt wird, wenn er in den Stream geschrieben wird.

documentSequencePartName

[in] Die IOpcPartUri-Schnittstelle , die den Teilenamen der Dokumentsequenz in der neuen Datei enthält.

coreProperties

[in] Die IXpsOMCoreProperties-Schnittstelle , die die wichtigsten Dokumenteigenschaften enthält, die der neuen Datei zugewiesen werden sollen. Dieser Parameter kann auf NULL festgelegt werden.

packageThumbnail

[in] Die IXpsOMImageResource-Schnittstelle , die das Miniaturbild enthält, das der neuen Datei zugewiesen werden soll. Dieser Parameter kann auf NULL festgelegt werden.

documentSequencePrintTicket

[in] Die IXpsOMPrintTicketResource-Schnittstelle , die das Druckticket auf Paketebene enthält, das der neuen Datei zugewiesen werden soll. Dieser Parameter kann auf NULL festgelegt werden.

discardControlPartName

[in] Die IOpcPartUri-Schnittstelle , die den Namen des Verwerfen-Steuerelementteils enthält. Dieser Parameter kann auf NULL festgelegt werden.

documentType

[in] Der Dokumenttyp des Paketschreibers. Der Wert dieses Parameters kann nicht XPS_DOCUMENT_TYPE_UNSPECIFIED werden.

packageWriter

[out, retval] Ein Zeiger auf die neue IXpsOMPackageWriter-Schnittstelle , die von dieser Methode erstellt wurde.

Rückgabewert

Mögliche Werte sind u. a. folgendes: Informationen zu XPS-Dokument-API-Rückgabewerten, die hier nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.

S_OK: Die Methode war erfolgreich, und packageWriter wurde ordnungsgemäß festgelegt.

E_INVALIDARG: Der Dokumenttyp war kein gültiges XPS-Dokumentformat.

Hinweise

Verwenden Sie diese Methode, um einen Paketschreiber für ein MSXPS-Dokument oder ein OpenXPS-Dokument zu erstellen. CreatePackageWriterOnStream, veröffentlicht in Windows 7, erstellt nur XPS-Dokumentdateien im MSXPS-Format.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	xpsobjectmodel_1.h
Bibliothek	Keine

Siehe auch

IXpsOMObjectFactory1

Freigeben über