IXpsOMObjectFactory1::CreatePackageWriterOnFile1-Methode (xpsobjectmodel_1.h)

Artikel
11/20/2024

Öffnet eine Datei zum Schreiben des Inhalts eines XPS-OM in ein XPS-Paket eines angegebenen Typs. Diese Methode erzeugt einen Paketschreiber für ein MSXPS-Dokument oder ein OpenXPS-Dokument.

Syntax

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] Der Name der zu erstellenden Datei.

securityAttributes

[in, eindeutig] Die SECURITY_ATTRIBUTES-Struktur, die zwei separate, aber verwandte Elemente enthält:

lpSecurityDescriptor-: ein optionaler Sicherheitsdeskriptor
bInheritHandle: ein boolescher Wert, der bestimmt, ob das zurückgegebene Handle von untergeordneten Prozessen geerbt werden kann.

Wenn lpSecurityDescriptorNULL-ist, wird der dem zurückgegebenen Handle zugeordnete Datei oder das dem zurückgegebenen Handle zugeordnete Gerät einem Standardsicherheitsdeskriptor zugewiesen.

Weitere Informationen zu securityAttributesfinden Sie unter CreateFile-.

flagsAndAttributes

[in] Gibt die Einstellungen und Attribute der zu erstellenden Datei an. Für die meisten Dateien kann der FILE_ATTRIBUTE_NORMAL Wert verwendet werden.

Weitere Informationen zu diesem Parameter finden Sie unter CreateFile-.

optimizeMarkupSize

[in] Ein boolescher Wert, der angibt, ob das Dokumentmarkup für die Größe optimiert wird, wenn der Inhalt des XPS-OM in das XPS-Paket geschrieben wird.

Wert	Bedeutung
TRUE-	Der Paketschreiber versucht, das Markup für die Mindestgröße zu optimieren.
FALSE-	Der Paket-Writer versucht nicht, eine Optimierung durchzuführen.

interleaving

[in] Gibt an, ob der Inhalt des XPS-OM beim Schreiben in die Datei interleaviert wird.

documentSequencePartName

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

coreProperties

[in] Die IXpsOMCoreProperties Schnittstelle, die die grundlegenden 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] Gibt den Dokumenttyp des Paketschreibers an. 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, aber nicht auf Folgendes beschränkt. 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.

Bemerkungen

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

zusätzliche Verweise

Weitere Verweise: Beschreibung der Legacymethode

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8 [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	xpsobjectmodel_1.h
Library	Nichts

Siehe auch

IXpsOMObjectFactory1

Freigeben über