Objetos de inicio y servicio

  • Artículo

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

VDS proporciona objetos para realizar actividades relacionadas con el servicio. En este tema se describe cada objeto.

Service Loader (objeto)

El objeto service loader proporciona los métodos que usan las aplicaciones para cargar e inicializar VDS. Para preparar VDS para su uso, una aplicación debe realizar las siguientes operaciones:

Para obtener un ejemplo de código, consulte Carga de VDS.

Permita siempre que el servicio se inicialice por completo antes de llamar a los métodos expuestos por el objeto de servicio. Use el método IVdsService::IsServiceReady para determinar el estado del proceso de carga. Use el método IVdsService::WaitForServiceReady para bloquear las llamadas a objetos VDS hasta que se complete la inicialización.

En la tabla siguiente se enumeran las interfaces, enumeraciones y estructuras relacionadas.

Tipo Elemento
Interfaces que siempre están expuestas por este objeto IVdsServiceLoader.
Enumeraciones asociadas Ninguno.
Estructuras asociadas Ninguno.

 

Service (objeto)

El objeto de servicio es un objeto multifuncional que es fundamental para todas las aplicaciones de VDS. Con este objeto, un llamador puede realizar las siguientes operaciones:

  • Determine el estado de la inicialización del servicio.
  • Recupere todos los proveedores de hardware o software registrados con VDS.
  • Informe sobre discos sin asignar.
  • Devuelve el tipo de sistema de archivos y la letra de unidad asociadas a los volúmenes de un disco.
  • Quite las rutas de acceso en modo de usuario sin usar y las carpetas montadas del Registro y actualice los discos.
  • Recibir notificaciones de VDS.
  • Reinicie el host.
  • Recupere puertos HBA de canal de fibra o adaptadores de iniciador iSCSI en el equipo local.
  • Prepare de forma segura los LUN expuestos como discos en el equipo local para su eliminación.

Las estructuras de notificación de VDS pasan GUID de objeto a todas las aplicaciones registradas con VDS para recibir notificaciones. Use el método IVdsService::GetObject para convertir un GUID de objeto en un puntero de objeto. Para obtener una descripción más completa del modelo de notificación, consulte Notificaciones de VDS.

En la tabla siguiente se enumeran las interfaces, enumeraciones y estructuras relacionadas.

Tipo Elemento
Interfaces que siempre están expuestas por este objeto IVdsService, IVdsServiceHba*, IVdsServiceIscsi*, IVdsServiceUninstallDisk*.
Interfaces que siempre se implementan, pero no se exponen a las aplicaciones IVdsAdmin
Enumeraciones asociadas VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAG, VDS_FILE_SYSTEM_PROP_FLAG.
Estructuras asociadas VDS_SERVICE_PROP, VDS_FILE_SYSTEM_PROP, VDS_FILE_SYSTEM_TYPE_PROP, VDS_DRIVE_LETTER_NOTIFICATION, VDS_FILE_SYSTEM_NOTIFICATION, VDS_MOUNT_POINT_NOTIFICATION.

 

*Windows Server 2003: Estas interfaces no se admiten hasta Windows Server 2003 R2.

Objeto adapter del iniciador

Un adaptador de adaptador de iniciador modela un adaptador de iniciador iSCSI en el equipo host del servicio VDS. El servicio VDS solo puede ver adaptadores de iniciador en el equipo local. El rol de un objeto de adaptador de iniciador es para administrar sesiones de inicio de sesión desde el equipo local a destinos iSCSI.

En la tabla siguiente se enumeran las interfaces, enumeraciones y estructuras relacionadas.

Tipo Elemento
Interfaces que siempre están expuestas por este objeto IVdsIscsiInitiatorAdapter*.
Enumeraciones asociadas VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG, VDS_ISCSI_AUTH_TYPE.
Estructuras asociadas VDS_ISCSI_INITIATOR_ADAPTER_PROP.

 

*Windows Server 2003: Esta interfaz no se admite hasta Windows Server 2003 R2.

Objeto Portal del iniciador

Un portal de iniciador modela un portal de iniciador iSCSI en un iniciador iSCSI. Un portal de iniciador es la combinación de una dirección IP y un puerto a través del cual un equipo host se conecta a un portal en un subsistema iSCSI. El rol de un objeto del portal del iniciador es actuar como uno de los puntos de conexión de una ruta de acceso de MPIO y para configurar las opciones de seguridad de IPSEC.

En la tabla siguiente se enumeran las interfaces, enumeraciones y estructuras relacionadas.

Tipo Elemento
Interfaces que siempre están expuestas por este objeto IVdsIscsiInitiatorPortal*.
Enumeraciones asociadas VDS_ISCSI_IPSEC_FLAG.
Estructuras asociadas VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEY, VDS_IPADDRESS.

 

*Windows Server 2003: Esta interfaz no se admite hasta Windows Server 2003 R2.

HBA Port (objeto)

El objeto de puerto HBA modela un puerto de adaptador de bus host (HBA) de Canal de fibra.

Use el método IVdsServiceHba::QueryHbaPorts para determinar los puertos HBA conocidos por VDS en el equipo local.

En la tabla siguiente se enumeran las interfaces, enumeraciones y estructuras relacionadas.

Tipo Elemento
Interfaces que siempre están expuestas por este objeto IVdsHbaPort*.
Enumeraciones asociadas VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG.
Estructuras asociadas VDS_HBAPORT_PROP.

 

*Windows Server 2003: Esta interfaz no se admite hasta Windows Server 2003 R2.

Modelo de objetos de VDS

IVdsServiceLoader::LoadService

Carga de VDS

IVdsService::GetObject

Notificaciones de VDS