Méthode IPortableDeviceContent ::Move (portabledeviceapi.h)
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 |
|
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. |
|
L’application ne dispose pas des droits nécessaires pour déplacer l’objet. |
|
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 |