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 |
---|---|
|
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 |
|
Libreria |
|