IPortableDeviceValuesCollection::GetAt-Methode

Die GetAt-Methode ruft ein Element aus der Auflistung durch einen nullbasierten Index 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 außerhalb des Bereichs.
E_POINTER	Ein erforderliches Zeigerargument war NULL.
E_UNEXPECTED	Die Auflistung enthält einen NULLIPortableDeviceValues-Zeiger .

Bemerkungen

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