Método IPortableDeviceProperties::SetValues (portabledeviceapi.h)

Artículo
08/25/2023

El método SetValues agrega o modifica una o varias propiedades en un objeto especificado en un dispositivo.

Sintaxis

HRESULT SetValues(
  [in]  LPCWSTR               pszObjectID,
  [in]  IPortableDeviceValues *pValues,
  [out] IPortableDeviceValues **ppResults
);

Parámetros

[in] pszObjectID

Puntero a una cadena terminada en null que contiene el identificador de objeto del objeto que se va a modificar. Para especificar el dispositivo, use WPD_DEVICE_OBJECT_ID.

[in] pValues

Puntero a una interfaz IPortableDeviceValues que contiene uno o varios pares de propiedades y valores que se van a establecer. Los valores existentes se sobrescribirán.

[out] ppResults

Dirección de una variable que recibe un puntero a una interfaz IPortableDeviceValues que contiene una colección de valores property/HRESULT. Cada valor (tipo VT_ERROR) describe el éxito o error del intento del conjunto de propiedades. El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella.

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	Se actualizaron todos los valores de propiedad especificados.
S_FALSE	No se pudieron modificar una o más propiedades. Los que no pudieron tener un HRESULT de tipo VT_ERROR en el parámetro ppResults recuperado.

Comentarios

Para eliminar una propiedad, llame a IPortableDeviceProperties::D elete. Una propiedad solo se puede eliminar si su atributo WPD_PROPERTY_ATTRIBUTE_CAN_WRITE es True. Este atributo se puede recuperar llamando a GetPropertyAttributes.