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
S_OK	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	PortableDeviceTypes.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDeviceValues

IPortableDeviceValues::GetBufferValue