IXpsOMObjectFactory::CreateDocumentStructureResource-Methode (xpsobjectmodel.h)

Artikel
12/22/2023

Erstellt eine IXpsOMDocumentStructureResource-Schnittstelle , die den Zugriff auf den Ressourcenstrom der Dokumentstruktur ermöglicht.

Syntax

HRESULT CreateDocumentStructureResource(
  [in]          IStream                         *acquiredStream,
  [in]          IOpcPartUri                     *partUri,
  [out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);

Parameter

[in] acquiredStream

Die schreibgeschützte IStream-Schnittstelle , die dieser Ressource zugeordnet werden soll. Dieser Parameter darf nicht NULL sein.

Wichtig Behandeln Sie diesen Stream als Single-Threaded Apartment-Objekt (STA). geben Sie sie nicht erneut ein.

[in] partUri

Die IOpcPartUri-Schnittstelle , die den Teilenamen enthält, der dieser Ressource zugewiesen werden soll. Dieser Parameter darf nicht NULL sein.

[out, retval] documentStructureResource

Ein Zeiger auf die neue IXpsOMDocumentStructureResource-Schnittstelle .

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	acquiredStream, partUri oder documentStructureResource ist NULL.

Hinweise

Der DocumentStructure-Teil eines XPS-Dokuments enthält die Dokumentgliederung, die mit den StoryFragments-Teilen die Lesereihenfolge jedes Elements definiert, das auf den festen Seiten des Dokuments angezeigt wird. Diese Schnittstelle ermöglicht es einem Programm, den XML-Inhalt des DocumentStructure-Teils zu lesen und auch den XML-Inhalt des DocumentStructure-Teils zu ersetzen.

Der DocumentStructure-Teil enthält das Dokumentframework und die Gliederung, die die Gesamtlesereihenfolge des Dokuments beschreibt. Die Lesereihenfolge ist in semantischen Blöcken organisiert, die als Geschichten bezeichnet werden. Geschichten sind logische Einheiten des Dokuments auf die gleiche Weise wie Artikel Einheiten in einem Magazin sind. Geschichten bestehen aus einem oder mehreren StoryFragments-Teilen.

Die StoryFragments-Teile enthalten Inhaltsstrukturmarkup, das die semantischen Blöcke der Geschichte definiert, z. B. die Absätze und Tabellen, aus denen der Inhalt der Geschichte besteht.

Der Inhalt der Teile DocumentStructure und StoryFragments wird in der XML-Papierspezifikation beschrieben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	xpsobjectmodel.h