Объекты запуска и службы
[Начиная с 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.
Связанные темы