Metodo IPortableDeviceValues::SetBufferValue
Il metodo SetBufferValue aggiunge un nuovo valore BYTE* (tipo VT_VECTOR | VT_UI1) o ne sovrascrive uno esistente.
Sintassi
HRESULT SetBufferValue(
[in] REFPROPERTYKEY key,
[in] BYTE *pValue,
[in] DWORD cbValue
);
Parametri
-
key [in]
-
REFPROPERTYKEY che specifica l'elemento da creare o sovrascrivere.
-
pValue [in]
-
BYTE* che contiene i dati da scrivere nell'elemento. I dati del buffer inviati vengono copiati nell'interfaccia, quindi il chiamante può liberare questo buffer dopo aver effettuato questa chiamata.
-
cbValue [in]
-
Dimensione del valore a cui punta pValue, in byte.
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
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.
L'impostazione di un buffer null o di dimensioni zero non è supportata.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|