IMDSPObject：：Move 方法 (mswmdm.h)

Move 方法會移動媒體裝置上的檔案或資料夾。

語法

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

[in] fuMode

要叫用 Move 作業的處理模式，以及要移動的方法。請指定下列兩種模式的其中一種。如果同時指定這兩種模式，則會使用區塊模式。

模式	Description
WMDM_MODE_BLOCK	作業將會使用區塊模式處理來執行。在作業完成之前，呼叫將不會傳回。
WMDM_MODE_THREAD	作業將會使用線程模式處理來執行。呼叫會立即傳回，而且作業將會在背景線程中執行。

下表列出旗標，指出物件將移至何處。此數據表中的一個值會使用位 OR，與上一個 Mode 數據表中的一個值結合。

移動方法	Description
WMDM_STORAGECONTROL_INSERTBEFORE	物件將會插入目標物件之前。
WMDM_STORAGECONTROL_INSERTINTO	物件將會插入目標物件。目標對象必須是資料夾。如果目標對像是檔案，這個方法就會失敗。
WMDM_STORAGECONTROL_INSERTAFTER	物件將會插入目標對象之後。

[in] pProgress

應用程式實作的 IWMDMProgress 介面指標，以追蹤進行中的作業進度。此參數是選擇性的，而且在使用時應該設定為 NULL 。

[in] pTarget

要放置目前物件之前或之後的目標物件指標。

方法會傳回 HRESULT。 Windows Media 中的所有介面方法裝置管理員都可以傳回下列任何錯誤碼類別：

如需可能錯誤碼的廣泛清單，請參閱錯誤碼。

檔案或目錄只能在相同的根記憶體內移動。呼叫這個方法的對象必須更新，以反映其新位置。

這個方法是一個選擇項目。如需詳細資訊，請參閱強制和選擇性介面。