IPortableDevicePropVariantCollection::GetAt-Methode

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

Syntax

HRESULT GetAt(
  [in]  const DWORD       dwIndex,
  [out]       PROPVARIANT *pValue
);

Parameter

dwIndex [ In]

DWORD, das den nullbasierten Index des abzurufenden Elements enthält.

pValue [ out]

Zeiger auf eine PROPVARIANT-Struktur. Der Aufrufer ist dafür verantwortlich, diesen Arbeitsspeicher durch Aufrufen von PropVariantClear frei zu geben.

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-ZEIGER
Ein erforderliches Zeigerargument war NULL.
E _ INVALIDARG
Der übergebene Index lag nicht im Bereich.

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Abrufen der von einem Gerät unterstützten funktionalen Kategorien.

Anforderungen

Anforderung Wert
Header
PortableDeviceTypes.h
Bibliothek
PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDevicePropVariantCollection-Schnittstelle

Abrufen eines Objektbezeichners aus einem persistenten eindeutigen Bezeichner

Abrufen unterstützter Dienstereignisse

Abrufen unterstützter Dienstformate

Abrufen unterstützter Dienstmethoden

Abrufen der von einem Gerät unterstützten Inhaltstypen

Abrufen der von einem Gerät unterstützten Funktionalen Kategorien

Abrufen der funktionalen Objektbezeichner für ein Gerät

Abrufen der von einem Gerät unterstützten Renderingfunktionen

Festlegen von Eigenschaften für mehrere Objekte