共用方式為

IVdsHwProviderStoragePools：：QueryStoragePools 方法 (vds.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
標頭 vds.h
程式庫 Uuid.lib

另請參閱

IVdsHwProviderStoragePools