IPortableDeviceValuesCollection::GetAt-Methode

Die GetAt-Methode ruft ein Element von einem nullbasierten Index aus der Auflistung ab.

Syntax

HRESULT GetAt(
  [in]  const DWORD                 dwIndex,
  [out]       IPortableDeviceValues **ppValues
);

Parameter

dwIndex [ In]

DWORD, das einen nullbasierten Index in der Auflistung angibt.

ppValues [ out]

Adresse einer Variablen, die einen Zeiger auf eine IPortableDeviceValues-Schnittstelle aus der Auflistung empfängt. Der Aufrufer ist für den Aufruf von Release auf dieser Schnittstelle verantwortlich, wenn er damit fertig ist.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S _ OK
Die Methode wurde erfolgreich ausgeführt.
E _ INVALIDARG
Der nullbasierte Index, der übergeben wurde, lag nicht im Bereich.
_E-ZEIGER
Ein erforderliches Zeigerargument war NULL.
E _ UNEXPECTED
Die Auflistung enthält einen NULL-IPortableDeviceValues-Zeiger.

Hinweise

Alle Änderungen, die an Werten in der abgerufenen Schnittstelle vorgenommen werden, werden an der in der Auflistung gespeicherten Version vorgenommen.

Anforderungen

Anforderung Wert
Header
PortableDeviceTypes.h
Bibliothek
PortableDeviceGUIDs.lib

Siehe auch

IPortableDeviceValuesCollection-Schnittstelle