Metodo IWMDMStorageControl::Move (mswmdm.h)

Articolo
02/29/2024

Il metodo Move sposta lo spazio di archiviazione corrente in una nuova posizione nel dispositivo.

Sintassi

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

Parametri

[in] fuMode

Modalità di elaborazione in base alla quale richiamare l'operazione Di spostamento e il tipo di spostamento da eseguire. Specificare esattamente una delle due modalità seguenti. Se vengono specificate entrambe le modalità, viene utilizzata la modalità di blocco.

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

Nella tabella seguente sono elencati i flag che indicano dove viene spostato l'oggetto. Un valore di questa tabella viene combinato con un valore della tabella Mode precedente usando un OR bit per bit.

Flag	Descrizione
WMDM_STORAGECONTROL_INSERTBEFORE	L'oggetto viene inserito prima dell'oggetto di destinazione.
WMDM_STORAGECONTROL_INSERTINTO	L'oggetto viene inserito nell'oggetto di destinazione.
WMDM_STORAGECONTROL_INSERTAFTER	L'oggetto viene inserito dopo l'oggetto di destinazione.

[in] pTargetObject

Puntatore all'oggetto prima o dopo il quale si desidera inserire l'oggetto corrente.

[in] pProgress

Puntatore facoltativo a un'interfaccia IWMDMProgress implementata dall'applicazione per tenere traccia dello stato di avanzamento di un'operazione in corso.

Valore restituito

Il metodo restituisce un valore 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

Un file o una directory può essere spostato solo all'interno della stessa risorsa di archiviazione radice.

Se viene specificato il flag WMDM_MODE_THREAD, è necessario ottenere lo stato di completamento chiamando IWMDMProgress2::End2 o IWMDMProgress3::End3. Questi metodi garantiranno il completamento dell'operazione e restituiranno anche un HRESULT con informazioni sull'esito positivo o negativo.

Se un'applicazione usa WMDM_MODE_THREAD e passa un parametro pProgress diverso da null, l'applicazione deve assicurarsi che l'oggetto a cui appartiene pProgress non venga eliminato definitivamente fino al completamento dell'operazione di spostamento, perché Windows Media Gestione dispositivi invierà notifiche di stato a questo oggetto. Questo oggetto può essere eliminato definitivamente solo dopo la ricezione di una notifica End. In caso contrario, si verificheranno violazioni dell'accesso.