Freigeben über


IPortableDeviceValues::GetAt-Methode

Die GetAt-Methode ruft einen Wert aus der Auflistung unter Verwendung des angegebenen nullbasierten Index 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 [ein, aus]

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

pValue [in, out]

Ein optionaler PROPVARIANT , der den Wert des angegebenen Elements abruft. Der Aufrufer muss den Speicher freigeben, indem er PropVariantClear aufruft, 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
Es wurde eine ungültige Indexnummer angegeben.

Bemerkungen

Wenn eine Eigenschaft einen Wert vom Typ VT_UNKNOWN angibt, handelt es sich bei der Eigenschaft um eine der portablen Windows-Geräte (IPortableDeviceKeyCollection, IPortableDeviceValuesCollection, IPortableDeviceValues oder IPortableDevicePropVariantCollection). Von Tragbaren Windows-Geräten können keine anderen Schnittstellen zurückgegeben werden.

Anforderungen

Anforderung Wert
Header
PortableDeviceTypes.h
Bibliothek
PortableDeviceGUIDs.lib

Siehe auch

IPortableDeviceValues-Schnittstelle

IPortableDeviceValues::GetStringValue