IPortableDeviceValues :: SetValue, méthode

La méthode SetValue ajoute une nouvelle valeur PROPVARIANT ou remplace celle qui existe déjà.

Syntaxe

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

Paramètres

clé [ dans]

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

pValue [ dans]

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 de retour

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

Code de retour Description
_OK
S_OK

Notes

Lorsque le VARTYPE de pValue est VT _ Vector ou VT _ UI1, la définition d’une mémoire tampon de taille zéro ou nulle n’est pas prise en charge. Par exemple, ni pValue. CAUB. pElems = null , ni pValue. CAUB. cElems = 0 n’est autorisé.

Cette méthode peut être utilisée pour récupérer une valeur de n’importe quel type 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 de clé , elle remplace la valeur existante sans avertissement. La mémoire clé existante est libérée de manière appropriée.

Spécifications

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

Voir aussi

Interface IPortableDeviceValues

IPortableDeviceValues :: GetValue

IPortableDeviceValues::RemoveValue