IPortableDeviceProperties ::D elete, méthode (portabledeviceapi.h)

  • Article

La méthode Delete supprime les propriétés spécifiées d’un objet spécifié sur un appareil.

Syntaxe

HRESULT Delete(
  [in] LPCWSTR                      pszObjectID,
  [in] IPortableDeviceKeyCollection *pKeys
);

Paramètres

[in] pszObjectID

Pointeur vers une chaîne terminée par null qui spécifie l’ID de l’objet dont vous allez supprimer les propriétés. Pour spécifier l’appareil, utilisez WPD_DEVICE_OBJECT_ID.

[in] pKeys

Pointeur vers une interface IPortableDeviceKeyCollection qui spécifie les propriétés à supprimer. Pour obtenir la liste des propriétés définies par les appareils portables Windows, consultez Propriétés et attributs.

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
S_FALSE
 Une ou plusieurs valeurs de propriété n’ont pas pu être supprimées.
E_POINTER
 L’argument de pointeur requis était NULL.

Remarques

Les propriétés ne peuvent être supprimées que si leur attribut WPD_PROPERTY_ATTRIBUTE_CAN_DELETE a la valeur True. Cet attribut peut être récupéré en appelant GetPropertyAttributes.

Le pilote n’a aucun moyen d’indiquer une réussite partielle ; autrement dit, si seules certaines propriétés peuvent être supprimées, le pilote retourne S_FALSE, mais cette méthode n’indique pas quelles propriétés ont été supprimées avec succès. La seule façon d’apprendre quelles propriétés ont été supprimées consiste à demander toutes les propriétés en appelant IPortableDeviceProperties ::GetValues.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête portabledeviceapi.h
Bibliothèque PortableDeviceGUIDs.lib

Voir aussi

IPortableDeviceProperties, interface