IPortableDeviceValues::SetBufferValue, méthode

Article
06/12/2023

La méthode SetBufferValue ajoute une nouvelle valeur BYTE* (type VT_VECTOR | VT_UI1) ou remplace un existant.

Syntaxe

HRESULT SetBufferValue(
  [in] REFPROPERTYKEY key,
  [in] BYTE           *pValue,
  [in] DWORD          cbValue
);

Paramètres

key [in]: REFPROPERTYKEY qui spécifie l’élément à créer ou à remplacer.
pValue [in]: BYTE* qui contient les données à écrire dans l’élément. Les données de mémoire tampon envoyées sont copiées dans l’interface, de sorte que l’appelant peut libérer cette mémoire tampon après avoir effectué cet appel.
cbValue [in]: Taille de la valeur pointée par pValue, en octets.

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

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.

La définition d’une mémoire tampon NULL ou d’une mémoire tampon de taille nulle n’est pas prise en charge.

Spécifications

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

Voir aussi

IPortableDeviceValues, interface
IPortableDeviceValues::GetBufferValue

Partager via