IXpsOMDictionary::Append-Methode (xpsobjectmodel.h)

Artikel
12/22/2023

Fügt eine IXpsOMShareable-Schnittstelle zusammen mit ihrem Schlüssel an das Ende des Wörterbuchs an.

Syntax

HRESULT Append(
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Parameter

[in] key

Der Schlüssel, der für diesen Eintrag verwendet werden soll.

Die Zeichenfolge, auf die der Schlüssel verweist, muss im Wörterbuch eindeutig sein.

[in] entry

Ein Zeiger auf die IXpsOMShareable-Schnittstelle , die an das Wörterbuch angefügt werden soll.

Ein Wörterbuch darf keine doppelten Schnittstellenzeiger enthalten. Dieser Parameter muss einen Schnittstellenzeiger enthalten, der sich noch nicht im Wörterbuch befindet.

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.
XPS_E_NO_CUSTOM_OBJECTS	entry verweist nicht auf eine erkannte Schnittstellenimplementierung. Die benutzerdefinierte Implementierung von XPS-Dokument-API-Schnittstellen wird nicht unterstützt.

Hinweise

Die in einem Wörterbuch gespeicherten Schnittstellenzeiger zeigen normalerweise auf Schnittstellen wie IXpsOMBrush und IXpsOMVisual, die von der IXpsOMShareable-Schnittstelle abgeleitet sind. Um den Schnittstellentyp zu bestimmen, rufen Sie die IXpsOMShareable::GetType-Methode auf.

Die folgende Abbildung veranschaulicht, wie das Wörterbuch durch die Append-Methode geändert wird.

Abbildung, die zeigt, wie Append dem Wörterbuch einen Eintrag hinzufügt

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