Partager via

Objets de démarrage et de service

  • Article

[À 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 :

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.

Modèle objet VDS

IVdsServiceLoader::LoadService

Chargement de VDS

IVdsService::GetObject

VDS Notifications