Méthode IPortableDeviceContent ::Move (portabledeviceapi.h)

Article
03/01/2024

La méthode Move déplace un ou plusieurs objets d’un emplacement sur l’appareil vers un autre.

Syntaxe

HRESULT Move(
  [in]      IPortableDevicePropVariantCollection *pObjectIDs,
  [in]      LPCWSTR                              pszDestinationFolderObjectID,
  [in, out] IPortableDevicePropVariantCollection **ppResults
);

Paramètres

[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 à déplacer.

[in] pszDestinationFolderObjectID

Pointeur vers une chaîne terminée par un caractère Null qui spécifie l’ID de la destination.

[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	Un ou plusieurs objets ont été supprimés, mais au moins un objet n’a pas pu être supprimé. Consultez ppFailedObjectIDs pour savoir quels objets n’ont pas été supprimés.
E_ACCESSDENIED	L’application ne dispose pas des droits nécessaires pour déplacer l’objet.
E_POINTER	Au moins l’un des arguments requis était un pointeur NULL .

Remarques

Si l’appareil spécifié prend en charge les opérations de déplacement sur un stockage fonctionnel, le paramètre pszDestinationFolderObjectID peut spécifier l’identificateur d’un stockage fonctionnel.

Exemples

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

Configuration requise

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

Voir aussi

IPortableDeviceContent, interface

Déplacement de contenu sur l’appareil

Partager via