Méthode IPortableDeviceValues::SetValue

La méthode SetValue ajoute une nouvelle valeur PROPVARIANT ou remplace une valeur existante.

Syntaxe

HRESULT SetValue(
  [in]       REFPROPERTYKEY key,
  [in] const PROPVARIANT    *pValue
);

Paramètres

clé [in]

REFPROPERTYKEY qui spécifie l’élément à créer ou à remplacer.

pValue [in]

PROPVARIANT qui spécifie la nouvelle valeur. Le Kit de développement logiciel (SDK) copie la valeur, de sorte que l’appelant peut libérer la variable locale 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.

Notes

Lorsque le VARTYPE pour pValue est VT_VECTOR ou VT_UI1, la définition d’une mémoire tampon NULL ou de taille nulle n’est pas prise en charge. Par exemple, ni pValue.caub.pElems = NULL ni pValue.caub.cElems = 0 ne sont autorisés.

Cette méthode peut être utilisée pour récupérer une valeur de n’importe quel type à partir de la collection. Toutefois, si vous connaissez le type de valeur à l’avance, utilisez l’une des méthodes Set... spécialisées de cette interface pour éviter la surcharge liée à l’utilisation directe des valeurs PROPVARIANT.

Si une valeur existante a la même clé que celle spécifiée par le paramètre key , elle remplace la valeur existante sans avertissement. La mémoire de clé existante est libérée de manière appropriée.

Spécifications

Voir aussi

IPortableDeviceValues, interface

IPortableDeviceValues::GetValue

IPortableDeviceValues::RemoveValue