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

Weitere Informationen

IXpsOMBrush

IXpsOMDictionary

IXpsOMShareable

IXpsOMVisual

XML Paper Specification