IWMDMStorageControl：：Rename 方法 (mswmdm.h)

發行項
02/29/2024

Rename 方法會重新命名目前的記憶體。

語法

HRESULT Rename(
  [in] UINT          fuMode,
  [in] LPWSTR        pwszNewName,
  [in] IWMDMProgress *pProgress
);

參數

[in] fuMode

用於 重新命名 作業的處理模式。請指定下列兩種模式的其中一種。如果同時指定這兩種模式，則會使用區塊模式。

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

[in] pwszNewName

指定新名稱之寬字元 Null 終止字串的指標。

[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 通知之後，才能終結此物件。若無法這麼做，將會導致存取違規。