Objets de démarrage et de service
[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API Gestion du stockage Windows.]
VDS fournit des objets pour effectuer des activités liées au service. Cette rubrique décrit chaque objet.
Objet Service Loader
L’objet chargeur de service fournit les méthodes utilisées par les applications pour charger et initialiser VDS. Pour préparer VDS à l’utilisation, une application doit effectuer les opérations suivantes :
- Créez une instance de l’objet de 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 à s’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 qui sont toujours exposées par cet objet | IVdsServiceLoader. |
| Énumérations associées | Aucune. |
| Structures associées | Aucune. |
Objet Service
L’objet de service est un objet multifonctionnel 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.
- Retourne le type de système de fichiers et la lettre de lecteur associés 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.
- Recevez des notifications VDS.
- Redémarrez l’hôte.
- Récupérez les ports HBA Fibre Channel ou les cartes d’initiateur iSCSI sur l’ordinateur local.
- Préparez en toute sécurité les LUN exposés en tant que 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 qui sont 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 avant Windows Server 2003 R2.
Objet d’adaptateur initiateur
Un objet d’adaptateur d’initiateur modélise une carte d’initiateur iSCSI sur l’ordinateur hôte du service VDS. Le service VDS peut uniquement afficher les cartes d’initiateur sur l’ordinateur local. Le rôle d’un objet d’adaptateur d’initiateur est de gérer les sessions de connexion de l’ordinateur local vers les cibles iSCSI.
Le tableau suivant répertorie les interfaces, les énumérations et les structures associées.
| Type | Élément |
|---|---|
| Interfaces qui sont 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 avant Windows Server 2003 R2.
Objet Portail de l’initiateur
Un objet portail d’initiateur modélise un portail d’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 d’accès MPIO et de configurer les paramètres de sécurité IPSEC.
Le tableau suivant répertorie les interfaces, les énumérations et les structures associées.
| Type | Élément |
|---|---|
| Interfaces qui sont 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 avant Windows Server 2003 R2.
Objet de port HBA
L’objet de port HBA modélise un port de l’adaptateur de bus hôte (HBA) Fibre Channel.
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, les énumérations et les structures associées.
| Type | Élément |
|---|---|
| Interfaces qui sont 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 avant Windows Server 2003 R2.
Rubriques connexes