IVdsDisk：：QueryExtents 方法 (vds.h)

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

傳回磁碟上所有範圍的詳細數據。

語法

HRESULT QueryExtents(
  [out] VDS_DISK_EXTENT **ppExtentArray,
  [out] LONG            *plNumberOfExtents
);

[out] ppExtentArray

接收的指標變數
VDS_DISK_EXTENT 結構的陣列。呼叫端必須使用 CoTaskMemFree 函式釋放此陣列。

[out] plNumberOfExtents

代表範圍總數的類型 LONG 位址。

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

傳回碼/值	描述
S_OK	已成功傳回範圍資訊。
VDS_E_PACK_OFFLINE 0x80042444L	無法存取磁碟所屬的套件。

使用這個方法來判斷建立或擴充磁碟區可用的可用空間量。您也可以使用範圍信息來判斷磁碟佔用多少磁碟區。有效的範圍類型包括：未知的範圍、免費範圍、數據範圍、OEM 範圍、ESP 範圍、MSR 範圍、LDM 元數據範圍，以及無法使用的範圍。數據範圍包含其上方磁碟區的連結。

如果磁碟是動態磁碟，則必須在在線。如果是基本磁碟或原始磁碟，它可以在在線或離線。