Método IPortableDevicePropVariantCollection::Add

O método Add adiciona um item à coleção.

Sintaxe

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

Parâmetros

pValue [in]

Ponteiro para um novo objeto PROPVARIANT a ser adicionado à coleção. Esse método copia o PROPVARIANT para a coleção, portanto, você deve liberar sua cópia local da variável 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 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.

Exemplos

Para obter um exemplo de como usar esse método, consulte Recuperando um identificador de objeto de um identificador exclusivo persistente

Requisitos

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

Confira também

IPortableDevicePropVariantCollection Interface

Movendo conteúdo no dispositivo

Recuperando um identificador de objeto de um identificador exclusivo persistente