IMDSPObject：：Move 方法 (mswmdm.h)

Move 方法在媒体设备上移动文件或文件夹。

语法

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

[in] fuMode

调用 Move 操作的处理模式和移动方法的处理模式。指定以下两种模式之一。如果同时指定了两种模式，则使用块模式。

“模式”	说明
WMDM_MODE_BLOCK	将使用块模式处理执行该操作。在操作完成之前，调用不会返回。
WMDM_MODE_THREAD	将使用线程模式处理来执行该操作。调用将立即返回，操作将在后台线程中执行。

下表列出了指示对象将移动到何处的标志。此表中的一个值使用按位 OR 与上述 Mode 表中的一个值组合在一起。

移动方法	说明
WMDM_STORAGECONTROL_INSERTBEFORE	对象将插入目标对象之前。
WMDM_STORAGECONTROL_INSERTINTO	对象将插入到目标对象中。目标对象必须是文件夹。如果目标对象是文件，则此方法将失败。
WMDM_STORAGECONTROL_INSERTAFTER	对象将插入目标对象之后。

[in] pProgress

指向应用程序实现的 IWMDMProgress 接口的指针，用于跟踪正在进行的操作的进度。此参数是可选的，在不使用时应设置为 NULL 。

[in] pTarget

指向要放置当前对象的之前或之后的目标对象的指针。

该方法返回 HRESULT。 Windows Media 设备管理器中的所有接口方法都可以返回以下任一类错误代码：

有关可能错误代码的广泛列表，请参阅错误代码。

文件或目录只能在同一根存储中移动。必须更新调用此方法的对象以反映其新位置。

此方法是可选的。有关详细信息，请参阅必需接口和可选接口。