IVdsAdvancedDisk：：QueryPartitions 方法 (vds.h)

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

傳回目前磁碟上所有分割區的詳細數據。

語法

HRESULT QueryPartitions(
  [out] VDS_PARTITION_PROP **ppPartitionPropArray,
  [out] LONG               *plNumberOfPartitions
);

[out] ppPartitionPropArray

呼叫端傳入之VDS_PARTITION_PROP 結構的陣列指標。呼叫端必須使用 CoTaskMemFree 函式釋放此陣列。

[out] plNumberOfPartitions

ppPartitionPropArray 參數所傳回陣列中元素數目的指標。

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

傳回碼	描述
S_OK	查詢成功。
S_FALSE	磁碟不包含任何分割區。

如果磁碟包含擴充分割區，這個方法只會傳回第一個擴充分割區，而不論磁碟上有多少擴充分割區。磁碟包含每個邏輯磁碟驅動器的一個擴充磁碟分區。如需邏輯磁碟驅動器的詳細資訊，請參閱磁碟物件。