Share via

IVdsVolume：:D elete 方法 (vds.h)

  • 發行項

[從Windows 8和Windows Server 2012開始，虛擬磁碟服務COM 介面會由Windows 儲存體管理 API取代。

刪除磁片區和所有叢集，釋放範圍。

語法

HRESULT Delete(
  [in] BOOL bForce
);

參數

[in] bForce

如果 為 TRUE，即使磁片區正在使用，VDS 也會刪除磁片區;否則，如果磁片區正在使用中，則不會刪除磁片區。

傳回值

這個方法可以傳回標準 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 VDS 特定的傳回值。 它也可以使用HRESULT_FROM_WIN32宏傳回已轉換的系統錯誤碼。 錯誤可能來自 VDS 本身，或來自正在使用的基礎 VDS 提供者 。 可能的傳回值包括下列專案。

傳回碼 描述
S_OK
 已成功刪除 plexes。

備註

您只能從線上套件刪除磁片區。 使用 IVdsPack：：GetProperties 方法來確認套件狀態 VDS_PS_ONLINE。

您無法刪除卸載式媒體上的磁片區。

VDS 會先卸載檔案系統，再刪除磁片區—FAT 和 FAT32 所需的作業，但不是 NTFS。 此外，VDS 會在刪除磁片區本身之後，刪除磁片區的所有存取路徑。 如果卸載作業失敗，且 bForce為 true，VDS 會刪除磁片區而不卸載。 檔案系統用戶端應用程式必須處理這種情況。 如果卸載成功，且刪除作業失敗，VDS 會嘗試重新掛接磁片區。

VDS 可防止刪除目前的系統和開機磁片區，以及分頁檔、損毀傾印和休眠磁片區。 您可以移動或重設 crashdump 和 pagefile。 休眠磁片區必須保留在開機磁碟分割上。

Windows Server 2003： 當機傾印和休眠磁片區必須保留在開機磁碟分割上。

Windows Server 2003： 刪除磁片區之後，VDS 會嘗試刪除掛接的資料夾。 如果失敗，即使已成功刪除磁片區， Delete 仍會傳回 VDS_S_ACCESS_PATH_NOT_DELETED。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 Windows
標頭 vds.h
程式庫 Uuid.lib

另請參閱

IVdsPack：：GetProperties

IVdsVolume

VDS_PACK_STATUS