Méthode IPortableDeviceProperties::SetValues (portabledeviceapi.h)
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 |
---|---|
|
Toutes les valeurs de propriété spécifiées ont été mises à jour. |
|
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.
Exemples
Pour obtenir un exemple d’utilisation de cette méthode, consultez Définition des propriétés d’un objet unique.
Configuration requise
Plateforme cible | Windows |
En-tête | portabledeviceapi.h |
Bibliothèque | PortableDeviceGUIDs.lib |
Voir aussi
IPortableDeviceProperties, interface
IPortableDeviceProperties::D elete
IPortableDeviceProperties::GetValues
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour