Объекты запуска и службы

  • Статья

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

VDS предоставляет объекты для выполнения действий, связанных со службами. В этом разделе описывается каждый объект .

Объект Service Loader

Объект загрузчика служб предоставляет методы, используемые приложениями для загрузки и инициализации VDS. Чтобы подготовить виртуальные диски к использованию, приложение должно выполнять следующие операции:

  • Создайте экземпляр объекта загрузчика службы, который возвращает интерфейс IVdsServiceLoader .
  • Вызовите метод IVdsServiceLoader::LoadService , чтобы загрузить службу.

Пример кода см. в разделе Загрузка VDS.

Всегда разрешайте службе полностью инициализироваться перед вызовом методов, предоставляемых объектом службы. Используйте метод IVdsService::IsServiceReady , чтобы определить состояние процесса загрузки. Используйте метод IVdsService::WaitForServiceReady для блокировки вызовов объектов VDS до завершения инициализации.

В следующей таблице перечислены связанные интерфейсы, перечисления и структуры.

Тип Элемент
Интерфейсы, которые всегда предоставляются этим объектом IVdsServiceLoader.
Связанные перечисления Нет.
Связанные структуры Нет.

 

Объект Service

Объект службы — это универсальный объект, который является центральным для всех приложений VDS. С помощью этого объекта вызывающий объект может выполнять следующие операции:

  • Определите состояние инициализации службы.
  • Получение всех поставщиков оборудования или программного обеспечения, зарегистрированных в VDS.
  • Отчет о нераспределенных дисках.
  • Возвращает тип файловой системы и букву диска, связанные с томами на диске.
  • Удалите неиспользуемые пути в пользовательском режиме и подключенные папки из реестра и обновите диски.
  • Получение уведомлений VDS.
  • Перезагрузите узел.
  • Получите порты адаптера HBA Fibre Channel или адаптеры инициатора iSCSI на локальном компьютере.
  • Безопасно подготовьте LUN, предоставляемые в качестве дисков на локальном компьютере, для удаления.

Структуры уведомлений VDS передают идентификаторы GUID объектов всем приложениям, зарегистрированным в VDS для получения уведомлений. Используйте метод IVdsService::GetObject для преобразования GUID объекта в указатель объекта. Более полное описание модели уведомлений см. в разделе Уведомления VDS.

В следующей таблице перечислены связанные интерфейсы, перечисления и структуры.

Тип Элемент
Интерфейсы, которые всегда предоставляются этим объектом IVdsService, IVdsServiceHba*, IVdsServiceIscsi*, IVdsServiceUninstallDisk*.
Интерфейсы, которые всегда реализуются, но не доступны для приложений IVdsAdmin
Связанные перечисления VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAGVDS_FILE_SYSTEM_PROP_FLAG.
Связанные структуры VDS_SERVICE_PROP, VDS_FILE_SYSTEM_PROP, VDS_FILE_SYSTEM_TYPE_PROP, VDS_DRIVE_LETTER_NOTIFICATION, VDS_FILE_SYSTEM_NOTIFICATIONVDS_MOUNT_POINT_NOTIFICATION.

 

*Windows Server 2003: Эти интерфейсы не поддерживаются до Windows Server 2003 R2.

Объект адаптера инициатора

Объект адаптера инициатора моделирует адаптер инициатора iSCSI на хост-компьютере службы VDS. Служба VDS может просматривать только адаптеры инициатора на локальном компьютере. Роль объекта адаптера инициатора заключается в управлении сеансами входа с локального компьютера в целевые объекты iSCSI.

В следующей таблице перечислены связанные интерфейсы, перечисления и структуры.

Тип Элемент
Интерфейсы, которые всегда предоставляются этим объектом IVdsIscsiInitiatorAdapter*.
Связанные перечисления VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG, VDS_ISCSI_AUTH_TYPE.
Связанные структуры VDS_ISCSI_INITIATOR_ADAPTER_PROP.

 

*Windows Server 2003: Этот интерфейс не поддерживается до Windows Server 2003 R2.

Объект портала инициатора

Объект портала инициатора моделирует портал инициатора iSCSI на инициаторе iSCSI. Портал инициатора — это сочетание IP-адреса и порта, через который главный компьютер подключается к порталу в подсистеме iSCSI. Роль объекта портала инициатора заключается в том, чтобы служить одной из конечных точек пути MPIO и настраивать параметры безопасности IPSEC.

В следующей таблице перечислены связанные интерфейсы, перечисления и структуры.

Тип Элемент
Интерфейсы, которые всегда предоставляются этим объектом IVdsIscsiInitiatorPortal*.
Связанные перечисления VDS_ISCSI_IPSEC_FLAG.
Связанные структуры VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEYVDS_IPADDRESS.

 

*Windows Server 2003: Этот интерфейс не поддерживается до Windows Server 2003 R2.

Объект порта HBA

Объект порта HBA моделирует порт адаптера шины Fibre Channel.

Используйте метод IVdsServiceHba::QueryHbaPorts , чтобы определить порты HBA, известные для VDS на локальном компьютере.

В следующей таблице перечислены связанные интерфейсы, перечисления и структуры.

Тип Элемент
Интерфейсы, которые всегда предоставляются этим объектом IVdsHbaPort*.
Связанные перечисления VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUSVDS_HBAPORT_SPEED_FLAG.
Связанные структуры VDS_HBAPORT_PROP.

 

*Windows Server 2003: Этот интерфейс не поддерживается до Windows Server 2003 R2.

Объектная модель VDS

IVdsServiceLoader::LoadService

Загрузка виртуальных жестких диска

IVdsService::GetObject

Уведомления VDS