共用方式為


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