Método IPortableDevicePropVariantCollection::Add (portabledevicetypes.h)

  • Artigo

Adiciona um item à coleção.

Sintaxe

HRESULT Add(
  [in] const PROPVARIANT *pValue
);

Parâmetros

[in] pValue

Ponteiro para um novo objeto PROPVARIANT a ser adicionado à coleção. Esse método copia o PROPVARIANT para a coleção. Você pode liberar sua cópia local da variável 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 e a recuperação de um buffer NULL ou de tamanho zero. Por exemplo, nem pValue.caub.pElems = NULL nem pValue.caub.cElems = 0 são permitidos.

Se um chamador tentar adicionar um item de um VARTYPE diferente contido na coleção e o valor PROPVARIANT não puder ser alterado por essa interface automaticamente, esse método falhará. Para alterar o tipo de coleção manualmente, chame IPortableDevicePropVariantCollection::ChangeType.

Requisitos

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

Confira também

IPortableDevicePropVariantCollection Interface