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

Artigo
08/25/2023

O método SetValues adiciona ou modifica uma ou mais propriedades em um objeto especificado em um dispositivo.

Sintaxe

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

Parâmetros

[in] pszObjectID

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a ID do objeto a ser modificado. Para especificar o dispositivo, use WPD_DEVICE_OBJECT_ID.

[in] pValues

Ponteiro para uma interface IPortableDeviceValues que contém um ou mais pares de propriedade/valor a serem definidos. Os valores existentes serão substituídos.

[out] ppResults

Endereço de uma variável que recebe um ponteiro para uma interface IPortableDeviceValues que contém uma coleção de valores de propriedade/HRESULT. Cada valor (tipo VT_ERROR) descreve o êxito ou a falha da tentativa do conjunto de propriedades. O chamador deve liberar essa interface quando terminar com ela.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	Todos os valores de propriedade especificados foram atualizados.
S_FALSE	Não foi possível modificar uma ou mais propriedades. Aqueles que não puderam ter um HRESULT do tipo VT_ERROR no parâmetro ppResults recuperado.

Comentários

Para excluir uma propriedade, chame IPortableDeviceProperties::D elete. Uma propriedade só poderá ser excluída se seu atributo WPD_PROPERTY_ATTRIBUTE_CAN_WRITE for True. Esse atributo pode ser recuperado chamando GetPropertyAttributes.