Método IMDSPObject::Move (mswmdm.h)

Artículo
03/05/2024

El método Move mueve un archivo o carpeta en un dispositivo multimedia.

Sintaxis

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

Parámetros

[in] fuMode

Modo de procesamiento por el que se va a invocar la operación Move y el método por el que se va a mover. Especifique exactamente uno de los dos modos siguientes. Si se especifican ambos modos, se usa el modo de bloque.

Mode	Descripción
WMDM_MODE_BLOCK	La operación se realizará mediante el procesamiento del modo de bloque. La llamada no se devolverá hasta que finalice la operación.
WMDM_MODE_THREAD	La operación se realizará mediante el procesamiento del modo de subproceso. La llamada se devolverá inmediatamente y la operación se realizará en un subproceso en segundo plano.

En la tabla siguiente se enumeran las marcas que indican dónde se moverá el objeto. Un valor de esta tabla se combina con un valor de la tabla Mode anterior mediante un or bit a bit.

Método de movimiento	Descripción
WMDM_STORAGECONTROL_INSERTBEFORE	El objeto se insertará antes del objeto de destino.
WMDM_STORAGECONTROL_INSERTINTO	El objeto se insertará en el objeto de destino. El objeto de destino debe ser una carpeta. Si el objeto de destino es un archivo, se produce un error en este método.
WMDM_STORAGECONTROL_INSERTAFTER	El objeto se insertará después del objeto de destino.

[in] pProgress

Puntero a una interfaz IWMDMProgress implementada por la aplicación para realizar un seguimiento del progreso de las operaciones en curso. Este parámetro es opcional y debe establecerse en NULL cuando no se use.

[in] pTarget

Puntero al objeto de destino antes o después del cual desea colocar el objeto actual.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

Códigos de error COM estándar
Códigos de error de Windows convertidos en valores HRESULT
Códigos de error de windows Media Administrador de dispositivos

Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Un archivo o directorio solo se puede mover dentro del mismo almacenamiento raíz. El objeto en el que se llama a este método debe actualizarse para reflejar su nueva ubicación.

Este método es opcional. Para obtener más información, consulte Interfaces obligatorias y opcionales.