Metodo IPortableDeviceValues::SetBufferValue (portabledevicetypes.h)

Aggiunge un nuovo valore BYTE* (tipo VT_VECTOR o VT_UI1) o sovrascrive uno esistente.

Sintassi

HRESULT SetBufferValue(
  [in] REFPROPERTYKEY key,
  [in] BYTE           *pValue,
  [in] DWORD          cbValue
);

Parametri

[in] key

REFPROPERTYKEY che specifica l'elemento da creare o sovrascrivere.

[in] pValue

Puntatore a un BYTE contenente 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.

[in] cbValue

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

L'impostazione di un buffer null o di dimensioni zero non è supportata.

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
Piattaforma di destinazione	Windows
Intestazione	portabledevicetypes.h

Vedi anche

Interfaccia IPortableDeviceValues

IPortableDeviceValues::GetBufferValue