IXpsOMObjectFactory1::CreatePackageFromFile1-Methode (xpsobjectmodel_1.h)

Artikel
08/28/2023

Öffnet eine XPS-Paketdatei und gibt eine instanziierte XPS-Dokumentobjektstruktur zurück. Diese Methode liest eine Datei, die ein XPS-Dokument vom Typ XPS_DOCUMENT_TYPE_ XPS oder XPS_DOCUMENT_TYPE_ OPENXPS enthält.

Syntax

HRESULT CreatePackageFromFile1(
  LPCWSTR        filename,
  BOOL           reuseObjects,
  IXpsOMPackage1 **package
);

Parameter

filename

[in, Zeichenfolge] Der Name der XPS-Paketdatei.

reuseObjects

[in] Der boolesche Wert, der angibt, dass die Software versucht, die Dokumentobjektstruktur zu optimieren, indem Objekte freigegeben werden, die in allen Eigenschaften und untergeordneten Elementen identisch sind.

TRUE: Die Software versucht, die Objektstruktur zu optimieren.

FALSE: Die Software versucht nicht, die Objektstruktur zu optimieren.

package

[out, retval] Ein Zeiger auf die neue IXpsOMPackage1-Schnittstelle, die die XPS-Dokumentobjektstruktur enthält, die aus Dateinamen gelesen wurde.

Rückgabewert

Die Methode gibt ein HRESULT zurück. 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.

XPS_E_UNEXPECTED_NAMESPACE: Das Paketmarkup verwendet einen Namespace, der vom Dokumenttyp nicht unterstützt wird.

XPS_E_ABSOLUTE_REFERENCE: Das OpenXPS-Dokument enthält XML-Elemente, die absolute URIs verwenden, um auf andere Teile im Dokument zu verweisen.

Hinweise

Verwenden Sie diese Methode, um eine Datei zu lesen, die ein XPS-Dokument enthält, das vom Typ XPS_DOCUMENT_TYPE_ XPS oder XPS_DOCUMENT_TYPE_ OPENXPS sein kann. CreatePackageFromFile, veröffentlicht in Windows 7, öffnet nur Dateien, die ein XPS-Dokument vom Typ XPS_DOCUMENT_TYPE_ XPS enthalten.

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