Objets de démarrage et de service
[À compter de Windows 8 et Windows Server 2012, l’interface COM service de disque virtuel est remplacée par l’API de gestion du stockage Windows .]
VDS fournit des objets pour effectuer des activités liées au service. Cette rubrique décrit chaque objet.
Objet Loader de service
L’objet chargeur de service fournit les méthodes utilisées par les applications pour charger et initialiser VDS. Pour préparer VDS à utiliser, une application doit effectuer les opérations suivantes :
- Créez une instance de l’objet chargeur de service, qui retourne l’interface IVdsServiceLoader.
- Appelez la méthode IVdsServiceLoader ::LoadService pour charger le service.
Pour obtenir un exemple de code, consultez Chargement de VDS.
Autorisez toujours le service à initialiser complètement avant d’appeler les méthodes exposées par l’objet de service. Utilisez la méthode IVdsService ::IsServiceReady pour déterminer l’état du processus de chargement. Utilisez la méthode IVdsService ::WaitForServiceReady pour bloquer les appels aux objets VDS jusqu’à la fin de l’initialisation.
Le tableau suivant répertorie les interfaces, les énumérations et les structures associées.
| Type | Élément |
|---|---|
| Interfaces toujours exposées par cet objet | IVdsServiceLoader. |
| Énumérations associées | Aucun. |
| Structures associées | Aucun. |
Objet de service
L’objet de service est un objet multifonctionnel qui est central pour toutes les applications VDS. Avec cet objet, un appelant peut effectuer les opérations suivantes :
- Déterminez l’état de l’initialisation du service.
- Récupérez tous les fournisseurs matériels ou logiciels inscrits auprès de VDS.
- Rapport sur les disques non alloués.
- Retournez le type de système de fichiers et la lettre de lecteur associées aux volumes sur un disque.
- Supprimez les chemins d’accès en mode utilisateur inutilisés et les dossiers montés du Registre et actualisez les disques.
- Recevoir des notifications VDS.
- Redémarrez l’hôte.
- Récupérez des ports HBA Fibre Channel ou des adaptateurs initiateurs iSCSI sur l’ordinateur local.
- Préparez en toute sécurité les numéros d’unité logique exposés sous forme de disques sur l’ordinateur local pour la suppression.
Les structures de notification VDS transmettent des GUID d’objet à toutes les applications inscrites auprès de VDS pour recevoir des notifications. Utilisez la méthode IVdsService ::GetObject pour convertir un GUID d’objet en pointeur d’objet. Pour obtenir une description plus complète du modèle de notification, consultez notifications VDS.
Le tableau suivant répertorie les interfaces, les énumérations et les structures associées.
| Type | Élément |
|---|---|
| Interfaces toujours exposées par cet objet | IVdsService, IVdsServiceHba*, IVdsServiceIscsi*, IVdsServiceUninstallDisk*. |
| Interfaces toujours implémentées, mais non exposées aux applications | IVdsAdmin |
| Énumérations associées | VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAG, VDS_FILE_SYSTEM_PROP_FLAG. |
| Structures associées | 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 : Ces interfaces ne sont pas prises en charge tant que Windows Server 2003 R2 n’est pas pris en charge.
Objet adaptateur initiateur
Un objet adaptateur initiateur modélise un adaptateur initiateur iSCSI sur l’ordinateur hôte du service VDS. Le service VDS ne peut afficher que les adaptateurs initiateurs sur l’ordinateur local. Le rôle d’un objet d’adaptateur initiateur consiste à gérer les sessions de connexion de l’ordinateur local vers des cibles iSCSI.
Le tableau suivant répertorie les interfaces, les énumérations et les structures associées.
| Type | Élément |
|---|---|
| Interfaces toujours exposées par cet objet | IVdsIscsiInitiatorAdapter*. |
| Énumérations associées | VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG, VDS_ISCSI_AUTH_TYPE. |
| Structures associées | VDS_ISCSI_INITIATOR_ADAPTER_PROP. |
*Windows Server 2003 : Cette interface n’est pas prise en charge tant que Windows Server 2003 R2 n’est pas pris en charge.
Objet du portail initiateur
Un objet du portail initiateur modélise un portail initiateur iSCSI sur un initiateur iSCSI. Un portail initiateur est la combinaison d’une adresse IP et d’un port via lequel un ordinateur hôte se connecte à un portail sur un sous-système iSCSI. Le rôle d’un objet portail initiateur est de servir de point de terminaison d’un chemin MPIO et de configurer les paramètres de sécurité IPSEC.
Le tableau suivant répertorie les interfaces, énumérations et structures associées.
| Type | Élément |
|---|---|
| Interfaces toujours exposées par cet objet | IVdsIscsiInitiatorPortal*. |
| Énumérations associées | VDS_ISCSI_IPSEC_FLAG. |
| Structures associées | VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEY, VDS_IPADDRESS. |
*Windows Server 2003 : Cette interface n’est pas prise en charge tant que Windows Server 2003 R2 n’est pas pris en charge.
HBA Port, objet
L’objet port HBA modélise un port HBA (Fibre Channel Host Bus Adapter).
Utilisez la méthode IVdsServiceHba ::QueryHbaPorts pour déterminer les ports HBA connus de VDS sur l’ordinateur local.
Le tableau suivant répertorie les interfaces, énumérations et structures associées.
| Type | Élément |
|---|---|
| Interfaces toujours exposées par cet objet | IVdsHbaPort*. |
| Énumérations associées | VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG. |
| Structures associées | VDS_HBAPORT_PROP. |
*Windows Server 2003 : Cette interface n’est pas prise en charge tant que Windows Server 2003 R2 n’est pas pris en charge.
Rubriques connexes