IPortableDeviceValues::SetValue-Methode

Die SetValue-Methode fügt einen neuen PROPVARIANT-Wert hinzu oder überschreibt einen vorhandenen Wert.

Syntax

HRESULT SetValue(
  [in]       REFPROPERTYKEY key,
  [in] const PROPVARIANT    *pValue
);

Parameter

key [in]

Ein REFPROPERTYKEY , der das zu erstellende oder überschreibende Element angibt.

pValue [in]

Ein PROPVARIANT , der den neuen Wert angibt. Das SDK kopiert den Wert, sodass der Aufrufer die lokale Variable freigeben kann, indem er PropVariantClear aufruft, nachdem diese Methode aufgerufen wurde.

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.

Bemerkungen

Wenn VARTYPE für pValue VT_VECTOR oder VT_UI1 ist, wird das Festlegen 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 Set...- Methoden dieser Schnittstelle, um den Aufwand der direkten Arbeit mit PROPVARIANT-Werten zu vermeiden.

Wenn ein vorhandener Wert denselben Schlüssel aufweist, der durch den Schlüsselparameter angegeben wird, überschreibt er den vorhandenen Wert ohne Warnung. Der vorhandene Schlüsselspeicher wird entsprechend freigegeben.

Anforderungen

Anforderung	Wert
Header	PortableDeviceTypes.h
Bibliothek	PortableDeviceGUIDs.lib

Siehe auch

IPortableDeviceValues-Schnittstelle

IPortableDeviceValues::GetValue

IPortableDeviceValues::RemoveValue