IWMDMStorageControl：:D elete 方法 (mswmdm.h)

發行項
02/29/2024

Delete 方法會永久刪除此記憶體。

語法

HRESULT Delete(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

參數

[in] fuMode

下列一或兩個旗標，結合位 OR。只指定前兩種模式之一;第三個模式是選擇性的。

模式	Description
WMDM_MODE_BLOCK	此作業是使用區塊模式執行， (同步處理) 。在作業完成之前，呼叫將不會傳回。
WMDM_MODE_THREAD	作業是使用線程模式執行， (異步) 處理。呼叫會立即傳回，並在背景線程中執行作業。
WMDM_MODE_RECURSIVE	如果記憶體對象是資料夾，則會刪除它及其內容，以及所有子資料夾及其內容。

[in] pProgress

Windows Media 裝置管理員用來回報進度回應用程式的 IWMDMProgress 介面選擇性指標。

傳回值

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

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

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

備註

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

當 Delete 作業完成時，已刪除物件的所有參考都會變成無效。應用程式必須釋放這些介面，以及與對象相關聯的任何其他介面或資源。

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