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

Artículo
03/05/2024

El método Move mueve el almacenamiento actual a una nueva ubicación en el dispositivo.

Sintaxis

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

Parámetros

[in] fuMode

Modo de procesamiento por el que se va a invocar la operación Move y el tipo de movimiento que se va a realizar. 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 realiza 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 realiza mediante el procesamiento del modo de subproceso. La llamada se devolverá inmediatamente y la operación se realiza en un subproceso en segundo plano.

En la tabla siguiente se muestran marcas que indican a dónde se mueve el objeto. Un valor de esta tabla se combina con un valor de la tabla Mode anterior mediante un OR bit a bit.

Marca	Descripción
WMDM_STORAGECONTROL_INSERTBEFORE	El objeto se inserta antes del objeto de destino.
WMDM_STORAGECONTROL_INSERTINTO	El objeto se inserta en el objeto de destino.
WMDM_STORAGECONTROL_INSERTAFTER	El objeto se inserta después del objeto de destino.

[in] pTargetObject

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

[in] pProgress

Puntero opcional a una interfaz IWMDMProgress implementada por la aplicación para realizar un seguimiento del progreso de una operación en curso.

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.

Si se especifica la marca WMDM_MODE_THREAD, debe obtener el estado de finalización llamando a IWMDMProgress2::End2 o IWMDMProgress3::End3. Estos métodos garantizarán que la operación está completa y también devolverán un HRESULT con información de éxito o error.

Si una aplicación usa WMDM_MODE_THREAD y pasa un parámetro pProgress no null, la aplicación debe asegurarse de que el objeto al que pertenece pProgress no se destruye hasta que se complete la operación de movimiento, ya que Windows Media Administrador de dispositivos enviará notificaciones de progreso a este objeto. Este objeto solo se puede destruir después de recibir una notificación de finalización. Si no lo hace, se producirán infracciones de acceso.