IPortableDevicePropVariantCollection::Add, méthode

La méthode Add ajoute un élément à la collection.

Syntaxe

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

Paramètres

pValue [in]

Pointeur vers un nouvel objet PROPVARIANT à ajouter à la collection. Cette méthode copie propVARIANT dans la collection. Vous devez donc libérer votre copie locale de la variable en appelant PropVariantClear après avoir appelé cette méthode.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK

Notes

Lorsque le VARTYPE pour pValue est VT_VECTOR ou VT_UI1, la définition et la récupération d’une mémoire tampon null ou nulle ne sont pas prises en charge. Par exemple, ni pValue.caub.pElems = NULL ni pValue.caub.cElems = 0 ne sont autorisés.

Si un appelant tente d’ajouter un élément d’un autre VARTYPE contenu dans la collection et que la valeur PROPVARIANT ne peut pas être modifiée automatiquement par cette interface, cette méthode échoue. Pour modifier manuellement le type de collection, appelez IPortableDevicePropVariantCollection::ChangeType.

Exemples

Pour obtenir un exemple d’utilisation de cette méthode, consultez Récupération d’un identificateur d’objet à partir d’un identificateur unique persistant

Spécifications

Condition requise	Valeur
En-tête	PortableDeviceTypes.h
Bibliothèque	PortableDeviceGUIDs.lib

Voir aussi

IPortableDevicePropVariantCollection, interface

Déplacement de contenu sur l’appareil

Récupération d’un identificateur d’objet à partir d’un identificateur unique persistant