Метод IVdsHwProvider::QuerySubSystems (vds.h)
[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]
Возвращает перечисление подсистем, управляемых поставщиком.
Синтаксис
HRESULT QuerySubSystems(
[out] IEnumVdsObject **ppEnum
);
Параметры
[out] ppEnum
Адрес указателя интерфейса IEnumVdsObject , который можно использовать для перечисления подсистем в качестве объектов подсистемы. Дополнительные сведения см. в статье Работа с объектами перечисления. Вызывающие объекты должны освободить интерфейс и каждый из объектов подсистемы, когда они больше не нужны, путем вызова метода IUnknown::Release .
Возвращаемое значение
Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать преобразованные коды системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.
| Возвращаемый код или значение | Описание |
|---|---|
|
Возвращает перечисление идентификаторов подсистемы. Если поставщик не управляет подсистемами, перечисление будет пустым. |
|
Это возвращаемое значение сигнализирует о проблеме программного обеспечения или связи внутри поставщика, который кэширует сведения о массиве. Для восстановления кэша используйте метод IVdsHwProvider::Reenumerate , за которым следует метод IVdsHwProvider::Refresh . |
|
Поставщик находится в состоянии сбоя и не может выполнить запрошенную операцию. |
|
Выполняется другая операция; Эта операция не может продолжаться до завершения предыдущей операции или операций. |
|
Метод инициализации не был вызван. |
Комментарии
Возвращаемый объект перечисляет все подсистемы, подключенные в данный момент к сети. Используйте метод IVdsHwProvider::Reenumerate для обнаружения новых подсистем. Используйте метод IVdsHwProvider::Refresh , чтобы обновить внутренние кэшированные данные поставщика для существующих подсистем.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vds.h |
| Библиотека | Uuid.lib |