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
);

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.

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.

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.

Anforderung	Wert
Header	PortableDeviceTypes.h
Bibliothek	PortableDeviceGUIDs.lib