IXpsOMPackageWriter::AddResource-Methode (xpsobjectmodel.h)

Artikel
03/05/2024

Erstellt eine neue Teilressource im Paket.

Syntax

HRESULT AddResource(
  [in] IXpsOMResource *resource
);

Parameter

[in] resource

Die IXpsOMResource-Schnittstelle der Teilressource, die als neuer Teil im Paket hinzugefügt wird. Informationen zu den Ressourcentypen, die in diesem Parameter möglicherweise übergeben werden, finden Sie unter Hinweise.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Informationen zu Rückgabewerten der XPS-Dokument-API, 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_INVALIDARG	Eine Ressource mit demselben Namen wie die Ressource, auf die von der Ressource verwiesen wird, wurde dem Stream bereits hinzugefügt, oder es gibt keine Beziehung, die die Ressource enthält, auf die von der Ressource verwiesen wird. Nachdem E_INVALIDARG zurückgegeben wurde, ist der Stream oder die Datei nicht mehr gültig, und Close gibt XPS_E_UNAVAILABLE_PACKAGE zurück.
XPS_E_UNAVAILABLE_PACKAGE	Es ist ein schwerwiegender Fehler aufgetreten, und der Inhalt des XPS OM kann möglicherweise nicht wiederhergestellt werden. Einige Komponenten des XPS OM können möglicherweise noch verwendet werden, aber erst, nachdem sie überprüft wurden. Da der Zustand des XPS OM nach der Rückgabe dieses Fehlers nicht vorhergesagt werden kann, sollten alle Komponenten des XPS OM freigegeben und verworfen werden.

Diese Methode ruft die Paketerstellungs-API auf. Informationen zu den Rückgabewerten der Verpackungs-API finden Sie unter Paketfehler.

Hinweise

Diese Methode erstellt einen neuen Teil im Dokumentpaket, der der Ressource entspricht, fügt dem neuen Teil den Inhalt der Ressource hinzu und schließt dann den neuen Teil.

Wenn diese Methode einen Fehler zurückgibt, kann der Paketwriter nicht mehr verwendet werden.

Der Ressourcenparameter muss einer der folgenden Sein:

Die IXpsOMFontResource-Schnittstelle einer Schriftartressource, die auf der aktuellen Seite oder einer seite verwendet wird, die bereits hinzugefügt wurde.
Die IXpsOMImageResource-Schnittstelle einer Bildressource, die auf der aktuellen Seite oder einer seite verwendet wird, die bereits hinzugefügt wurde.
Die IXpsOMColorProfileResource-Schnittstelle der Farbprofilressource, die auf der aktuellen Seite oder einer bereits hinzugefügten Seite verwendet wird.
Die IXpsOMStoryFragmentsResource-Schnittstelle einer Storyfragmentressource, die auf der aktuellen Seite oder einer bereits hinzugefügten Seite verwendet wird.
Die IXpsOMDocumentStructureResource-Schnittstelle einer Dokumentstrukturressource, die im aktuellen Dokument oder in einem dokument verwendet wird, das bereits hinzugefügt wurde.
Die IXpsOMSignatureBlockResource-Schnittstelle einer Signaturblockressource, die im aktuellen Dokument oder in einem dokument verwendet wird, das bereits hinzugefügt wurde.

Diese Methode gibt einen Fehler zurück, wenn die Ressource eine der folgenden Elemente enthält:

Die IXpsOMRemoteDictionaryResource-Schnittstelle eines Remoteressourcenwörterbuchs.
Die IXpsOMPrintTicketResource-Schnittstelle eines Drucktickets.
Die IXpsOMImageResource-Schnittstelle eines Miniaturbilds.

Diese Methode gibt einen Fehler zurück, wenn eine Ressource auf eine Ressource verweist, die denselben Namen hat wie eine Ressource, die bereits dem Stream hinzugefügt wurde oder für die keine Beziehung vorhanden ist.

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