IXpsOMDocument::GetPageReferences-Methode (xpsobjectmodel.h)

Artikel
03/13/2024

Ruft die IXpsOMPageReferenceCollection-Schnittstelle des Dokuments ab, die den virtualisierten Zugriff auf seine Seiten ermöglicht.

Syntax

HRESULT GetPageReferences(
  [out, retval] IXpsOMPageReferenceCollection **pageReferences
);

Parameter

[out, retval] pageReferences

Ein Zeiger auf die IXpsOMPageReferenceCollection-Schnittstelle , die eine Sammlung von Seitenverweise für jede Seite des Dokuments enthält. Wenn keine Seitenverweise vorhanden sind, ist die in pageReferences zurückgegebene IXpsOMPageReferenceCollection leer und enthält keine Elemente.

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	pageReferences ist NULL.

Hinweise

Um die Seiten eines Dokuments abzurufen, rufen Sie zuerst die Liste der IXpsOMPageReference-Schnittstellen ab, indem Sie GetPageReferences aufrufen. Laden Sie dann für jede IXpsOMPageReference-Schnittstelle eine Seite, indem Sie GetPage aufrufen.

Wenn das Dokument keine Seiten enthält, ist die in pageReferences zurückgegebene Seitenverweisauflistung leer. Rufen Sie die GetCount-Methode auf, um die Anzahl der Seitenverweise in der Auflistung abzurufen.

Ein Beispiel dafür, wie diese Methode in einem Programm verwendet werden kann, finden Sie unter Navigieren im XPS-OM.

Anforderungen

Anforderung	Wert
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