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

Artigo
02/29/2024

O método Move move o armazenamento atual para um novo local no dispositivo.

Sintaxe

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

Parâmetros

[in] fuMode

Modo de processamento pelo qual invocar a operação Mover e o tipo de movimentação a ser realizada. Especifique exatamente um dos dois modos a seguir. Se ambos os modos forem especificados, o modo de bloco será usado.

Mode	Descrição
WMDM_MODE_BLOCK	A operação é executada usando o processamento do modo de bloco. A chamada não retornará até que a operação seja concluída.
WMDM_MODE_THREAD	A operação é executada usando o processamento do modo thread. A chamada retornará imediatamente e a operação será executada em um thread em segundo plano.

A tabela a seguir lista os sinalizadores que indicam para onde o objeto é movido. Um valor dessa tabela é combinado com um valor da tabela mode anterior usando um OR bit a bit.

Sinalizador	Descrição
WMDM_STORAGECONTROL_INSERTBEFORE	O objeto é inserido antes do objeto de destino.
WMDM_STORAGECONTROL_INSERTINTO	O objeto é inserido no objeto de destino.
WMDM_STORAGECONTROL_INSERTAFTER	O objeto é inserido após o objeto de destino.

[in] pTargetObject

Ponteiro para o objeto antes ou depois do qual você deseja colocar o objeto atual.

[in] pProgress

Ponteiro opcional para uma interface IWMDMProgress que foi implementada pelo aplicativo para acompanhar o progresso de uma operação em andamento.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

Códigos de erro COM padrão
Códigos de erro do Windows convertidos em valores HRESULT
Códigos de erro de Gerenciador de Dispositivos do Windows Media

Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Um arquivo ou diretório só pode ser movido dentro do mesmo armazenamento raiz.

Se o sinalizador WMDM_MODE_THREAD for especificado, você deverá obter status de conclusão chamando IWMDMProgress2::End2 ou IWMDMProgress3::End3. Esses métodos garantirão que a operação seja concluída e também retornarão um HRESULT com informações de êxito ou falha.

Se um aplicativo usa WMDM_MODE_THREAD e passa um parâmetro pProgress não nulo, o aplicativo deve garantir que o objeto ao qual o pProgress pertence não seja destruído até que a operação de movimentação seja concluída, pois a Gerenciador de Dispositivos do Windows Media enviará notificações de progresso para esse objeto. Esse objeto só pode ser destruído depois de receber uma notificação End. A falha ao fazer isso resultará em violações de acesso.