IPortableDeviceValues::GetValue-Methode

Die GetValue-Methode ruft einen PROPVARIANT-Wert ab, der durch einen Schlüssel angegeben wird.

Syntax

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

Parameter

Key [ In]

Ein REFPROPERTYKEY-Schlüssel, der das abzurufende Element angibt.

pValue [ out]

Zeiger auf den abgerufenen PROPVARIANT-Wert. Der Aufrufer muss den Arbeitsspeicher durch Aufrufen von PropVariantClear frei geben, 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.
HRESULT _ FROM _ WIN32(ERROR _ NOT _ FOUND)
Die durch key angegebene Eigenschaft ist nicht in der Auflistung.

Hinweise

Wenn VARTYPE für pValue VT VECTOR oder VT UI1 ist, wird das Abrufen eines Nullpuffers oder eines Puffers der _ Größe _ 0 (null) nicht unterstützt. Beispielsweise sind weder pValue.caub.pElems = NULL noch pValue.caub.cElems = 0 zulässig.

Diese Methode kann verwendet werden, um einen Wert eines beliebigen Typs aus der Auflistung abzurufen. Wenn Sie den Werttyp jedoch im Voraus kennen, verwenden Sie eine der speziellen Abrufmethoden dieser Schnittstelle, um den Mehraufwand der direkten Arbeit mit PROPVARIANT-Werten zu vermeiden.

Anforderungen

Anforderung Wert
Header
PortableDeviceTypes.h
Bibliothek
PortableDeviceGUIDs.lib

Siehe auch

IPortableDeviceValues-Schnittstelle

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue