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 提供者 。 可能的傳回值包括下列專案。
傳回碼 | 描述 |
---|---|
|
已成功刪除 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 |