Metodo IPortableDeviceValues::SetValue

Il metodo SetValue aggiunge un nuovo valore PROPVARIANT o ne sovrascrive uno esistente.

Sintassi

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

Parametri

key [in]

REFPROPERTYKEY che specifica l'elemento da creare o sovrascrivere.

pValue [in]

PROPVARIANT che specifica il nuovo valore. L'SDK copia il valore, in modo che il chiamante possa rilasciare la variabile locale chiamando PropVariantClear dopo aver chiamato questo metodo.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Quando varTYPE per pValue è VT_VECTOR o VT_UI1, l'impostazione di un buffer NULL o di dimensioni zero non è supportata. Ad esempio, non sono consentiti pValue.caub.pElems = NULL né pValue.caub.cElems = 0.

Questo metodo può essere utilizzato per recuperare un valore di qualsiasi tipo dalla raccolta. Tuttavia, se si conosce il tipo di valore in anticipo, usare uno dei metodi Set ... specializzati di questa interfaccia per evitare il sovraccarico di utilizzo diretto dei valori PROPVARIANT.

Se un valore esistente ha la stessa chiave specificata dal parametro chiave , sovrascrive il valore esistente senza alcun avviso. La memoria della chiave esistente viene rilasciata in modo appropriato.

Requisiti

Requisito	Valore
Intestazione	PortableDeviceTypes.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDeviceValues

IPortableDeviceValues::GetValue

IPortableDeviceValues::RemoveValue