Método IPortableDeviceValues::SetBufferValue

El método SetBufferValue agrega un nuevo valor BYTE* (tipo VT_VECTOR | VT_UI1) o sobrescribe uno existente.

Sintaxis

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

Parámetros

key [in]

REFPROPERTYKEY que especifica el elemento que se va a crear o sobrescribir.

pValue [in]

BYTE* que contiene los datos que se van a escribir en el elemento. Los datos del búfer enviado se copian en la interfaz, por lo que el autor de la llamada puede liberar este búfer después de realizar esta llamada.

cbValue [in]

Tamaño del valor al que apunta pValue, en bytes.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Comentarios

Si un valor existente tiene la misma clave especificada por el parámetro key , sobrescribe el valor existente sin ninguna advertencia. La memoria de clave existente se libera correctamente.

No se admite establecer un valor NULL o un búfer de tamaño cero.

Requisitos

Requisito	Value
Encabezado	PortableDeviceTypes.h
Biblioteca	PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceValues (Interfaz)

IPortableDeviceValues::GetBufferValue