IXpsOMDictionary::GetByKey-Methode (xpsobjectmodel.h)
Ruft den IXpsOMShareable-Schnittstellenzeiger des Eintrags ab, der den angegebenen Schlüssel enthält.
Syntax
HRESULT GetByKey(
[in] LPCWSTR key,
[in] IXpsOMShareable *beforeEntry,
[out, retval] IXpsOMShareable **entry
);
Parameter
[in] key
Der Schlüssel des Eintrags, der im Wörterbuch zu finden ist.
[in] beforeEntry
Der IXpsOMShareable-Schnittstellenzeiger auf den letzten Eintrag im Wörterbuch, der nach dem Schlüssel gesucht werden soll. Wenn beforeEntryNULL ist oder ein Schnittstellenzeiger auf einen Eintrag ist, der sich nicht im Wörterbuch befindet, wird das gesamte Wörterbuch durchsucht.
[out, retval] entry
Der Schnittstellenzeiger auf den Wörterbucheintrag, dessen Schlüssel mit dem Schlüssel übereinstimmt.
Rückgabewert
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
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.
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 |