IXpsOMDictionary::GetAt-Methode (xpsobjectmodel.h)
Ruft den IXpsOMShareable-Schnittstellenzeiger und die Schlüsselnamenzeichenfolge des Eintrags an einem angegebenen Index im Wörterbuch ab.
Syntax
HRESULT GetAt(
[in] UINT32 index,
[out] LPWSTR *key,
[out, retval] IXpsOMShareable **entry
);
Parameter
[in] index
Der nullbasierte Index des zu erhaltenden Wörterbucheintrags.
[out] key
Die Schlüsselzeichenfolge, die an der durch den Index angegebenen Position gefunden wird.
[out, retval] entry
Der IXpsOMShareable-Schnittstellenzeiger , der an der durch den Index angegebenen Position gefunden wird.
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.
Diese Methode weist den Arbeitsspeicher zu, der von der Zeichenfolge verwendet wird, die als Schlüssel zurückgegeben wird. Wenn key nicht NULL ist, verwenden Sie die CoTaskMemFree-Funktion , um den Arbeitsspeicher freizugeben.
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 |