Objetos de inicio y servicio
[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:
- Cree una instancia del objeto de cargador de servicio, que devuelve la interfaz IVdsServiceLoader .
- Llame al método IVdsServiceLoader::LoadService para cargar el servicio.
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.
Temas relacionados