IPortableDeviceValues::GetAt-Methode

Die GetAt-Methode ruft einen Wert aus der Auflistung mithilfe des angegebenen nullbasierten Indexes ab.

Syntax

HRESULT GetAt(
  [in]      const DWORD       index,
  [in, out]       PROPERTYKEY *pKey,
  [in, out]       PROPVARIANT *pValue
);

Parameter

Index [ In]

Ein DWORD, das einen nullbasierten Index in der Auflistung angibt.

pKey [ in, out]

Ein optionaler PROPERTYKEY-Zeiger, der den Schlüssel des angegebenen Elements abruft.

pValue [ in, out]

Ein optionales PROPVARIANT, das den Wert des angegebenen Elements abruft. Der Aufrufer muss den Arbeitsspeicher freigeben, indem er PropVariantClear aufruft, wenn dies abgeschlossen 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
Es wurde eine ungültige Indexnummer angegeben.

Hinweise

Wenn eine Eigenschaft einen Wert vom Typ VT _ UNKNOWN angibt, ist die Eigenschaft eines der Windows Portable Devices (IPortableDeviceKeyCollection, IPortableDeviceValuesCollection, IPortableDeviceValues oder IPortableDevicePropVariantCollection). Von Windows Portable Devices können keine anderen Schnittstellen zurückgegeben werden.

Anforderungen

Anforderung Wert
Header
PortableDeviceTypes.h
Bibliothek
PortableDeviceGUIDs.lib

Siehe auch

IPortableDeviceValues-Schnittstelle

IPortableDeviceValues::GetStringValue