Metodo IMDSPObject::Move (mswmdm.h)

Articolo
08/25/2023

Il metodo Move sposta un file o una cartella in un dispositivo multimediale.

Sintassi

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

Parametri

[in] fuMode

Modalità di elaborazione in base alla quale richiamare l'operazione Move e il metodo in base al quale spostare. Specificare esattamente una delle due modalità seguenti. Se vengono specificate entrambe le modalità, viene usata la modalità di blocco.

Mode	Descrizione
WMDM_MODE_BLOCK	L'operazione verrà eseguita usando l'elaborazione in modalità blocco. La chiamata non restituirà fino al termine dell'operazione.
WMDM_MODE_THREAD	L'operazione verrà eseguita usando l'elaborazione in modalità thread. La chiamata restituirà immediatamente e l'operazione verrà eseguita in un thread in background.

La tabella seguente elenca i flag che indicano dove verrà spostato l'oggetto. Un valore di questa tabella viene combinato con un valore della tabella Mode precedente usando un OR bit per bit.

Metodo di spostamento	Descrizione
WMDM_STORAGECONTROL_INSERTBEFORE	L'oggetto verrà inserito prima dell'oggetto di destinazione.
WMDM_STORAGECONTROL_INSERTINTO	L'oggetto verrà inserito nell'oggetto di destinazione. L'oggetto di destinazione deve essere una cartella. Se l'oggetto di destinazione è un file, questo metodo ha esito negativo.
WMDM_STORAGECONTROL_INSERTAFTER	L'oggetto verrà inserito dopo l'oggetto di destinazione.

[in] pProgress

Puntatore a un'interfaccia IWMDMProgress implementata dall'applicazione per tenere traccia dello stato di avanzamento delle operazioni in corso. Questo parametro è facoltativo e deve essere impostato su NULL quando non viene usato.

[in] pTarget

Puntatore all'oggetto di destinazione prima o dopo il quale si vuole inserire l'oggetto corrente.

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

È possibile spostare un file o una directory solo all'interno della stessa risorsa di archiviazione radice. L'oggetto in cui viene chiamato questo metodo deve essere aggiornato per riflettere la nuova posizione.

È facoltativo. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.