Método IPortableDeviceValues::SetValue (portabledevicetypes.h)

  • Artigo

Adiciona um novo valor ou substitui um existente.

Sintaxe

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

Parâmetros

[in] key

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

[in] pValue

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.

Retornar valor

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 conjuntos especializados... métodos dessa interface para evitar a sobrecarga de trabalhar diretamente com PROPVARIANTs

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

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho portabledevicetypes.h

Confira também

IPortableDeviceValues Interface

IPortableDeviceValues::GetValue

IPortableDeviceValues::RemoveValue