共用方式為

IVdsHwProviderStoragePools：：QueryStoragePools 方法 (vdshwprv.h)

  • 發行項

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

會傳回 IEnumVdsObject 列舉物件，其中包含硬體提供者所管理的 存放集 區清單。

語法

HRESULT QueryStoragePools(
  [in]  ULONG               ulFlags,
  [in]  ULONGLONG           ullRemainingFreeSpace,
  [in]  VDS_POOL_ATTRIBUTES *pPoolAttributes,
  [out] IEnumVdsObject      **ppEnum
);

參數

[in] ulFlags

一個或多個 VDS_STORAGE_POOL_TYPE 旗標的位元遮罩，指定要查詢的存放集區類型。 其中一個旗標必須是VDS_SPT_CONCRETE或VDS_SPT_PRIMORDIAL。 此參數的預設值為零。 值為零表示應該查詢所有存放集區。

[in] ullRemainingFreeSpace

每個存放集區必須包含的最小可用空間量，以位元組為單位。 此參數的預設值為零。 值為零表示存放集區可以包含任意數量的可用空間。

[in] pPoolAttributes

VDS_POOL_ATTRIBUTES結構的指標，指定傳回存放集區必須具有的屬性值。 此參數的預設值為 Null。 Null值表示存放集區可以有任何屬性值。

[out] ppEnum

可用來列舉存放集區的 IEnumVdsObject 介面指標位址。 如需詳細資訊，請參閱 使用列舉物件。 呼叫端呼叫 IUnknown：：Release 方法不再需要它們時，必須釋放介面和每個存放集區物件。 這個參數是必要的，而且不能是 Null。

傳回值

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

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

備註

如果硬體提供者未管理任何存放集區，這個方法會傳回空的列舉物件。

如果在pPoolAttributes參數中指定了非Null值，這個方法只會傳回滿足VDS_POOL_ATTRIBUTES結構中所指定之所有屬性的儲存集區。 如果指定了任何最小值和最大值屬性，則傳回的存放集區必須完全符合這些屬性。 提示屬性會用來做為提示，進一步篩選滿足所有指定屬性的存放集區。 如果指定的屬性不適用於任何存放集區，這個方法會傳回具有空列舉物件的S_OK。

規格需求

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

另請參閱

IVdsHwProviderStoragePools