MÉTHODE IMDSPObject ::Move (mswmdm.h)

Article
08/25/2023

La méthode Move déplace un fichier ou un dossier sur un périphérique multimédia.

Syntaxe

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress,
  [in] IMDSPStorage  *pTarget
);

Paramètres

[in] fuMode

Mode de traitement par lequel appeler l’opération Move et la méthode de déplacement. Spécifiez exactement l’un des deux modes suivants. Si les deux modes sont spécifiés, le mode bloc est utilisé.

Mode	Description
WMDM_MODE_BLOCK	L’opération sera effectuée à l’aide du traitement en mode bloc. L’appel ne sera pas retourné tant que l’opération n’est pas terminée.
WMDM_MODE_THREAD	L’opération sera effectuée à l’aide du traitement en mode thread. L’appel est retourné immédiatement et l’opération est effectuée dans un thread d’arrière-plan.

Le tableau suivant répertorie les indicateurs qui indiquent où l’objet sera déplacé. Une valeur de cette table est combinée avec une valeur de la table Mode précédente à l’aide d’un OR au niveau du bit.

Méthode de déplacement	Description
WMDM_STORAGECONTROL_INSERTBEFORE	L’objet sera inséré avant l’objet cible.
WMDM_STORAGECONTROL_INSERTINTO	L’objet sera inséré dans l’objet cible. L’objet cible doit être un dossier. Si l’objet cible est un fichier, cette méthode échoue.
WMDM_STORAGECONTROL_INSERTAFTER	L’objet sera inséré après l’objet cible.

[in] pProgress

Pointeur vers une interface IWMDMProgress implémentée par l’application pour suivre la progression des opérations en cours. Ce paramètre est facultatif et doit être défini sur NULL lorsqu’il n’est pas utilisé.

[in] pTarget

Pointeur vers l’objet cible avant ou après lequel vous souhaitez placer l’objet actuel.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes suivantes de codes d’erreur :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Un fichier ou un répertoire ne peut être déplacé que dans le même stockage racine. L’objet sur lequel cette méthode est appelée doit être mis à jour pour refléter son nouvel emplacement.

Cette méthode est facultative. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.