Méthode IPortableDeviceContent ::D elete (portabledeviceapi.h)

Article
03/04/2024

La méthode Delete supprime un ou plusieurs objets de l’appareil.

Syntaxe

HRESULT Delete(
  [in]      const DWORD                          dwOptions,
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

Paramètres

[in] dwOptions

L’un des énumérateurs DELETE_OBJECT_OPTIONS .

[in] pObjectIDs

Pointeur vers une interface IPortableDevicePropVariantCollection qui contient une ou plusieurs chaînes terminées par null (type VT_LPWSTR) spécifiant les ID d’objet des objets à supprimer.

[in, out] ppResults

facultatif. Au retour, ce paramètre contient une collection de valeurs VT_ERROR indiquant la réussite ou l’échec de l’opération. Le premier élément retourné dans ppResults correspond au premier objet de la collection pObjectIDs , le deuxième élément retourné dans ppResults correspond au deuxième objet de la collection pObjectIDs , et ainsi de suite. Ce paramètre peut être NULL si l’application n’est pas concernée par les résultats.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Si une valeur d’erreur est retournée, aucun objet n’a été supprimé sur l’appareil.

Code de retour	Description
S_OK	S_OK
S_FALSE	Au moins un objet n’a pas pu être supprimé. Le paramètre ppResults , s’il est spécifié, contient le code d’erreur par objet.
E_XXXXXXXX	Le pilote n’a pas supprimé d’objets.
E_INVALIDARG	Une valeur non valide a été spécifiée pour dwOptions.
E_ACCESSDENIED	L’application n’est pas autorisée à supprimer l’objet.
HRESULT_FROM_WIN32(ERROR_DIR_NOT_EMPTY)	Impossible de supprimer le dossier ou répertoire spécifié, car il n’était pas vide.
HRESULT_FROM_WIN32(ERROR_INVALID_OPERATION)	L’application spécifiée PORTABLE_DEVICE_DELETE_NO_RECURSION et l’objet a des enfants.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Impossible de supprimer l’objet, car il n’existe pas sur l’appareil.

Remarques

Pour voir si la suppression récursive est prise en charge, appelez IPortableDeviceCapabilities ::GetCommandOptions. Si l’interface IPortableDeviceValues récupérée contient une valeur de propriété appelée WPD_OPTION_OBJECT_MANAGEMENT_RECURSIVE_DELETE_SUPPORTED avec la valeur boolVal True, l’appareil prend en charge la suppression récursive.

Le tableau suivant répertorie les codes de retour possibles qui peuvent apparaître dans la collection à laquelle ppResults pointe.

Exemples

Pour obtenir un exemple d’utilisation de cette méthode, consultez Suppression de contenu de l’appareil.

Configuration requise

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

Voir aussi

Suppression de contenu de l’appareil

IPortableDeviceContent, interface

Partager via