IWMDMStorageControl ::Move, méthode (mswmdm.h)

Article
03/04/2024

La méthode Move déplace le stockage actuel vers un nouvel emplacement sur l’appareil.

Syntaxe

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMStorage  *pTargetObject,
  [in] IWMDMProgress *pProgress
);

Paramètres

[in] fuMode

Mode de traitement par lequel appeler l’opération Move et le type de déplacement à effectuer. 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 est 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 est 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 est 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.

Indicateur	Description
WMDM_STORAGECONTROL_INSERTBEFORE	L’objet est inséré avant l’objet cible.
WMDM_STORAGECONTROL_INSERTINTO	L’objet est inséré dans l’objet cible.
WMDM_STORAGECONTROL_INSERTAFTER	L’objet est inséré après l’objet cible.

[in] pTargetObject

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

[in] pProgress

Pointeur facultatif vers une interface IWMDMProgress implémentée par l’application pour suivre la progression d’une opération en cours.

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.

Si l’indicateur WMDM_MODE_THREAD est spécifié, vous devez obtenir l’achèvement status en appelant IWMDMProgress2 ::End2 ou IWMDMProgress3 ::End3. Ces méthodes garantissent que l’opération est terminée et retournent également un HRESULT avec des informations de réussite ou d’échec.

Si une application utilise WMDM_MODE_THREAD et passe un paramètre pProgress non null, l’application doit s’assurer que l’objet auquel appartient pProgress n’est pas détruit tant que l’opération de déplacement n’est pas terminée, car Windows Media Gestionnaire de périphériques envoie des notifications de progression à cet objet. Cet objet ne peut être détruit qu’après avoir reçu une notification De fin. Si vous ne le faites pas, vous obtiendrez des violations d’accès.