IPortableDeviceValues::SetValue-Methode (portabledevicetypes.h)

Artikel
02/29/2024

Fügt einen neuen Wert hinzu oder überschreibt einen vorhandenen Wert.

Syntax

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

Parameter

[in] key

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

[in] pValue

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.

Hinweise

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 jedoch den Werttyp im Voraus kennen, verwenden Sie einen der spezialisierten Set... Methoden dieser Schnittstelle, um den Aufwand der direkten Arbeit mit PROPVARIANTs 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.