IXpsOMDictionary::GetAt-Methode (xpsobjectmodel.h)

Artikel
12/22/2023

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