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 |
|---|---|
|
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 |
|
| Biblioteca |
|