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

Article
03/04/2024

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

Partager via