IWMDMStorageControl：：Move 方法 (mswmdm.h)

發行項
03/05/2024

Move 方法會將目前的儲存設備移至裝置上的新位置。

語法

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

參數

[in] fuMode

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

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

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

旗標	描述
WMDM_STORAGECONTROL_INSERTBEFORE	物件會插入目標物件之前。
WMDM_STORAGECONTROL_INSERTINTO	物件會插入目標物件。
WMDM_STORAGECONTROL_INSERTAFTER	物件會插入目標對象之後。

[in] pTargetObject

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

[in] pProgress

應用程式已實作的 IWMDMProgress 介面選擇性指標，以追蹤進行中作業的進度。

傳回值

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

標準 COM 錯誤碼
轉換成 HRESULT 值的 Windows 錯誤碼
Windows Media 裝置管理員錯誤碼

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

備註

檔案或目錄只能在相同的根記憶體內移動。

如果指定WMDM_MODE_THREAD旗標，您應該呼叫 IWMDMProgress2：：End2 或 IWMDMProgress3：：End3 來取得完成狀態。這些方法可確保作業已完成，也會傳回具有成功或失敗資訊的 HRESULT。

如果應用程式使用 WMDM_MODE_THREAD 並傳遞非 Null pProgress 參數，應用程式必須確保 pProgress 所屬的對象在行動作業完成之前不會終結，因為 Windows Media 裝置管理員會將進度通知傳送至此物件。只有在收到 End 通知之後，才能終結此物件。若無法這麼做，將會導致存取違規。