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

Artigo
03/05/2024

O método Move move um arquivo ou pasta em um dispositivo de mídia.

Sintaxe

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

Parâmetros

[in] fuMode

Modo de processamento pelo qual invocar a operação Move e o método pelo qual mover. 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 será 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 será 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 será movido. Um valor dessa tabela é combinado com um valor da tabela mode anterior usando um OR bit a bit.

Método de movimentação	Descrição
WMDM_STORAGECONTROL_INSERTBEFORE	O objeto será inserido antes do objeto de destino.
WMDM_STORAGECONTROL_INSERTINTO	O objeto será inserido no objeto de destino. O objeto de destino deve ser uma pasta. Se o objeto de destino for um arquivo, esse método falhará.
WMDM_STORAGECONTROL_INSERTAFTER	O objeto será inserido após o objeto de destino.

[in] pProgress

Ponteiro para uma interface IWMDMProgress que foi implementada pelo aplicativo para acompanhar o progresso das operações em andamento. Esse parâmetro é opcional e deve ser definido como NULL quando não estiver sendo usado.

[in] pTarget

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

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. O objeto no qual esse método é chamado deve ser atualizado para refletir sua nova localização.

Esse método é opcional. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.