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 |
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 |
|
| Bibliothèque |
|