IPortableDeviceValues::GetAt-Methode (portabledevicetypes.h)

Ruft einen Wert aus der Auflistung durch einen nullbasierten Index ab.

Syntax

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

Parameter

[in] index

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

[in, out] pKey

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

[in, out] pValue

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.

Hinweise

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

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portabledevicetypes.h

Weitere Informationen

IPortableDeviceValues-Schnittstelle

IPortableDeviceValues::GetStringValue