IVssDifferentialSoftwareSnapshotMgmt3::D eleteUnusedDiffAreas 方法 (vsmgmt.h)

刪除所有陰影複製儲存區域 (也稱為未使用中之指定磁碟區上的差異區域) 。

語法

HRESULT DeleteUnusedDiffAreas(
  [in] VSS_PWSZ pwszDiffAreaVolumeName
);

參數

[in] pwszDiffAreaVolumeName

磁碟區的名稱。 這個參數是必要的,而且不能是 NULL

名稱必須是下列其中一種格式,且必須包含尾端反斜杠 (\) :

  • 掛接資料夾的路徑,例如 Y:\MountX\
  • 驅動器號,例如 D:\
  • 格式為 \\?\Volume{GUID}\ 的磁碟區 GUID 路徑 (GUID 可識別磁碟區)

傳回值

以下是此方法的有效傳回碼。

意義
S_OK
陰影複製儲存區域已成功刪除。
E_ACCESSDENIED
0x80070005L
呼叫端不是系統管理員。
E_INVALIDARG
0x80070057L
其中一個參數值無效。
E_NOTIMPL
0x80000001L
磁碟區的提供者不支援陰影複製保護。
VSS_E_PROVIDER_VETO
0x80042306L
發生預期的提供者錯誤。 錯誤碼會記錄在事件記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理
VSS_E_OBJECT_NOT_FOUND
0x80042308L
找不到指定的磁碟區。

備註

當相關聯的原始磁碟區因為保護錯誤而離線時,在儲存區域磁碟區上找到未使用的陰影複製儲存區域檔案。 在某些情況下,原始磁碟區可能會永久遺失,而呼叫 DeleteUnusedDiffAreas 方法是復原放棄的儲存區域空間的唯一方法。

規格需求

需求
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 vsmgmt.h

另請參閱

IVssDifferentialSoftwareSnapshotMgmt3