Método IPortableDeviceValues::SetValue

El método SetValue agrega un nuevo valor PROPVARIANT o sobrescribe uno existente.

Sintaxis

HRESULT SetValue(
  [in]       REFPROPERTYKEY key,
  [in] const PROPVARIANT    *pValue
);

Parámetros

key [in]

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

pValue [in]

PROPVARIANT que especifica el nuevo valor. El SDK copia el valor para que el autor de la llamada pueda liberar la variable local llamando a PropVariantClear después de llamar a este método.

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

Cuando se VT_VECTOR o VT_UI1 varTYPE para pValue , no se admite el establecimiento de un búfer null o de tamaño cero. Por ejemplo, no se permiten pValue.caub.pElems = NULL ni pValue.caub.cElems = 0.

Este método se puede usar para recuperar un valor de cualquier tipo de la colección. Sin embargo, si conoce el tipo de valor de antemano, use uno de los métodos set ... especializados de esta interfaz para evitar la sobrecarga de trabajar con valores PROPVARIANT directamente.

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.

Requisitos

Requisito	Value
Encabezado	PortableDeviceTypes.h
Biblioteca	PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceValues (Interfaz)

IPortableDeviceValues::GetValue

IPortableDeviceValues::RemoveValue