共用方式為

IVdsVolume：:D elete 方法 （vds.h）

  • 發行項

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

刪除磁碟區和所有 plexes，釋放範圍。

語法

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 會在刪除磁碟區本身之後，刪除磁碟區的所有存取路徑。 如果卸除作業失敗，且 bForcetrue，VDS 會刪除磁碟區而不卸除。 檔案系統用戶端應用程式必須處理這種情況。 如果卸除成功，且刪除作業失敗，VDS 會嘗試重新掛接磁碟區。

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

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

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

要求

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

另請參閱

IVdsPack：：GetProperties

IVdsVolume

VDS_PACK_STATUS