(vds.h) IVdsOpenVDisk：：Compact 方法

  • 發行項

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

壓縮虛擬磁碟以減少備份文件的實體大小。

語法

HRESULT Compact(
  [in]  COMPACT_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONG                     Reserved,
  [out] IVdsAsync                 **ppAsync
);

參數

[in] Flags

指定虛擬磁碟壓縮方式 的COMPACT_VIRTUAL_DISK_FLAG 列舉值。 必須設定為 COMPACT_VIRTUAL_DISK_FLAG_NONE。

[in] Reserved

此參數保留給系統使用。

[out] ppAsync

在成功完成時 ，IVdsAsync 介面的指標會收到 IVdsAsync 介面來監視和控制這項作業。 呼叫端必須在介面完成時釋放收到的介面。 如果在介面上呼叫 IVdsAsync：：Wait 方法，並傳回成功的 HRESULT 值，則必須在每個介面指標上呼叫 IUnknown：：Release 方法，以釋放VDS_ASYNC_OUTPUT結構中傳回的介面。 不過，如果 Wait 傳回失敗 HRESULT 值，或 Wait 的 pHrResult 參數收到失敗 HRESULT 值，則VDS_ASYNC_OUTPUT結構中的介面指標為 NULL 且不需要釋放。 您可以使用 Winerror.h 中定義的 SUCCEEDED 和 FAILED 宏來測試成功或失敗 HRESULT 值。

傳回值

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

傳回碼 描述
S_OK
 已成功完成命令。

備註

只有在虛擬磁碟處於下列其中一種狀態時，才能壓縮虛擬磁碟：

  • 離線模式 (中斷連結)
  • 使用唯讀存取 (在線模式連結並開啟)
如果它處於任何其他狀態，壓縮作業就會失敗。

虛擬磁碟必須是可擴充的 (也稱為動態) 或差異虛擬磁碟。

作業可以安全地中斷，稍後再重新執行。 如果作業中斷並重新開啟支援檔案，當開啟檔案時，檔案的大小可能會降低。

作業可以是 CPU 密集或 I/O 密集，或兩者皆取決於虛擬磁碟的大小，以及有多少未使用的區塊需要操作。

這個方法會回收未使用的空間，以減少虛擬磁碟備份儲存區檔案的大小。 如果針對中斷鏈接的虛擬磁碟呼叫這個方法，它就只能回收從未用來寫入數據的檔案空間。 如果是針對已連結並開啟且具有唯讀存取權的虛擬磁碟呼叫，就能夠回收一次使用但稍後釋放的空間。 針對以唯讀存取連結和開啟的虛擬磁碟呼叫這個方法，會回收備份存儲區檔案中可用空間的最大數量。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 vds.h
程式庫 Uuid.lib

另請參閱

IVdsOpenVDisk