IXpsOMDictionary::Append-Methode (xpsobjectmodel.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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.
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 |