Méthode IPortableDeviceProperties::SetValues (portabledeviceapi.h)

Article
08/25/2023

La méthode SetValues ajoute ou modifie une ou plusieurs propriétés sur un objet spécifié sur un appareil.

Syntaxe

HRESULT SetValues(
  [in]  LPCWSTR               pszObjectID,
  [in]  IPortableDeviceValues *pValues,
  [out] IPortableDeviceValues **ppResults
);

Paramètres

[in] pszObjectID

Pointeur vers une chaîne terminée par null qui contient l’ID d’objet de l’objet à modifier. Pour spécifier l’appareil, utilisez WPD_DEVICE_OBJECT_ID.

[in] pValues

Pointeur vers une interface IPortableDeviceValues qui contient une ou plusieurs paires propriété/valeur à définir. Les valeurs existantes seront remplacées.

[out] ppResults

Adresse d’une variable qui reçoit un pointeur vers une interface IPortableDeviceValues qui contient une collection de valeurs property/HRESULT. Chaque valeur (type VT_ERROR) décrit la réussite ou l’échec de la tentative de jeu de propriétés. L’appelant doit libérer cette interface lorsqu’il a terminé avec elle.

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	Toutes les valeurs de propriété spécifiées ont été mises à jour.
S_FALSE	Impossible de modifier une ou plusieurs propriétés. Ceux qui n’ont pas pu avoir un HRESULT de type VT_ERROR dans le paramètre ppResults récupéré.

Notes

Pour supprimer une propriété, appelez IPortableDeviceProperties::D elete. Une propriété ne peut être supprimée que si son attribut WPD_PROPERTY_ATTRIBUTE_CAN_WRITE a la valeur True. Cet attribut peut être récupéré en appelant GetPropertyAttributes.