Метод IVdsHwProviderStoragePools::QueryStoragePools (vds.h)

[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Возвращает объект перечисления 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 . Возможные возвращаемые значения включают следующие.

Комментарии

Если поставщик оборудования не управляет пулами носителей, этот метод возвращает пустой объект перечисления.

Если в параметре pPoolAttributes указано значение, отличное от NULL, этот метод возвращает только пулы носителей, удовлетворяющие всем атрибутам, указанным в структуре VDS_POOL_ATTRIBUTES. Если указаны минимальные и максимальные атрибуты, возвращаемые пулы носителей должны точно соответствовать этим атрибутам. Атрибуты подсказки используются в качестве указаний для дальнейшей фильтрации пулов носителей, удовлетворяющих всем указанным атрибутам. Если указанный атрибут не применяется ни к одному из пулов носителей, этот метод возвращает S_OK с пустым объектом перечисления.

Требования

См. также раздел

IVdsHwProviderStoragePools