IPortableDeviceValues::GetValue-Methode (portabledevicetypes.h)

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

Syntax

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

Parameter

[in] key

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

[out] pValue

Ein Zeiger auf den abgerufenen PROPVARIANT-Wert . Der Aufrufer muss den Arbeitsspeicher freigeben, indem er PropVariantClear aufruft, wenn der Aufruf abgeschlossen ist.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Rückgabewerte sind in der folgenden Tabelle aufgeführt.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Die eigenschaft, die durch key angegeben wird, ist nicht in der Auflistung enthalten.

Hinweise

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 für die zusätzliche Typüberprüfung.

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.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portabledevicetypes.h

Weitere Informationen

IPortableDeviceValues-Schnittstelle

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue