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

Статья
03/08/2023

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

Код возврата	Описание
S_OK	Метод завершился успешно.

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

Требования


Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	vdshwprv.h
Библиотека	Uuid.lib

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

IVdsHwProviderStoragePools