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 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.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Die durch schlüssel angegebene Eigenschaft befindet sich nicht in der Auflistung.

Bemerkungen

Wenn VARTYPE für pValue VT_VECTOR oder VT_UI1 ist, wird das Abrufen eines Null - oder Null-Puffers 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 spezialisierten Abrufmethoden dieser Schnittstelle, um den Aufwand 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