Método IPortableDeviceValues::SetValue

O método SetValue adiciona um novo valor PROPVARIANT ou substitui um existente.

Sintaxe

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

Parâmetros

chave [in]

Um REFPROPERTYKEY que especifica o item a ser criado ou substituído.

pValue [in]

Um PROPVARIANT que especifica o novo valor. O SDK copia o valor para que o chamador possa liberar a variável local chamando PropVariantClear depois de chamar esse método.

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	O método foi bem-sucedido.

Comentários

Quando o VARTYPE para pValue é VT_VECTOR ou VT_UI1, não há suporte para a configuração de um buffer NULL ou de tamanho zero. Por exemplo, nem pValue.caub.pElems = NULL nem pValue.caub.cElems = 0 são permitidos.

Esse método pode ser usado para recuperar um valor de qualquer tipo da coleção. No entanto, se você souber o tipo de valor com antecedência, use um dos métodos de Conjunto... especializados dessa interface para evitar a sobrecarga de trabalhar com valores PROPVARIANT diretamente.

Se um valor existente tiver a mesma chave especificada pelo parâmetro de chave , ele substituirá o valor existente sem nenhum aviso. A memória de chave existente é liberada adequadamente.

Requisitos

Requisito	Valor
parâmetro	PortableDeviceTypes.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceValues Interface

IPortableDeviceValues::GetValue

IPortableDeviceValues::RemoveValue