Objets de démarrage et de service

[à partir de Windows 8 et Windows Server 2012, l’interface COM du Service de disque virtuel est remplacée par l' API de gestion des Stockage Windows.]

VDS fournit des objets pour effectuer des activités liées aux services. Cette rubrique décrit chaque objet.

Objet de chargeur de service

L’objet chargeur de service fournit les méthodes utilisées par les applications pour charger et initialiser VDS. Pour préparer le VDS en vue de son utilisation, une application doit effectuer les opérations suivantes :

Pour obtenir un exemple de code, consultez chargement de VDS.

Autorisez toujours l’initialisation complète du service 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’à ce que l’initialisation se termine.

Le tableau suivant répertorie les interfaces, énumérations et 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 de matériel ou de 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, puis actualisez les disques.
  • Recevoir des notifications VDS.
  • Redémarrez l’hôte.
  • Récupérez Fibre Channel ports HBA ou des adaptateurs d’initiateur iSCSI sur l’ordinateur local.
  • Préparez en toute sécurité les numéros d’unités logiques exposés en tant que disques sur l’ordinateur local en vue de leur suppression.

Les structures de notification VDS transmettent les GUID d’objet à toutes les applications qui sont inscrites auprès de VDS pour recevoir des notifications. Utilisez la méthode IVdsService :: GetObject pour convertir un GUID d’objet en un pointeur d’objet. Pour obtenir une description plus complète du modèle de notification, consultez la page notifications VDS.

Le tableau suivant répertorie les interfaces, énumérations et structures associées.

Type Élément
Interfaces toujours exposées par cet objet IVdsService, IVdsServiceHba * , IVdsServiceIscsi * , IVdsServiceUninstallDisk * .
Interfaces qui sont toujours implémentées mais ne sont pas exposées aux applications IVdsAdmin
Énumérations associées VDS _ _ _ indicateur de fournisseur de requêtes, _ _ type d’objet VDS, _ _ indicateur de service VDS, indicateur de _ _ lettre _ de lecteur VDS, indicateur de _ _ système _ de fichiers VDS, _ _ _ _ indicateur de prop de système de fichiers VDS.
Structures associées VDS _ SERVICE _ prop, système de fichiers VDS _ _ _ prop, type de système de fichiers VDS _ _ _ _ prop, message de _ lettre de lecteur _ _ VDS, notification du _ système de fichiers _ _ VDS, notification de _ point de montage _ _ VDS.

* Windows server 2003 : ces interfaces ne sont pas prises en charge tant que Windows Server 2003 R2.

Objet adaptateur de l’initiateur

Un objet adaptateur d’initiateur modélise un adaptateur d’initiateur iSCSI sur l’ordinateur hôte du service VDS. Le service VDS peut uniquement afficher les adaptateurs initiateur sur l’ordinateur local. Le rôle d’un objet adaptateur de l’initiateur est de gérer les sessions de connexion entre l’ordinateur local et les cibles iSCSI.

Le tableau suivant répertorie les interfaces, énumérations et structures associées.

Type Élément
Interfaces toujours exposées par cet objet IVdsIscsiInitiatorAdapter * .
Énumérations associées VDS _ _ _ type de connexion iSCSI. VDS _ _ _ indicateur de connexion iSCSI, _ _ _ type d’authentification iSCSI VDS.
Structures associées VDS _ carte de l' _ initiateur iSCSI _ _ prop.

* Windows server 2003 : cette interface n’est pas prise en charge tant que Windows Server 2003 R2.

Objet portail de l’initiateur

Un objet portail de l’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 par le biais duquel un ordinateur hôte se connecte à un portail sur un sous-système iSCSI. Le rôle d’un objet portail de l’initiateur est de servir de l’un des points 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, énumérations et structures associées.

Type Élément
Interfaces toujours exposées par cet objet IVdsIscsiInitiatorPortal * .
Énumérations associées VDS _ _ _ indicateur IPSec iSCSI.
Structures associées VDS _ portail de l' _ initiateur iSCSI _ _ prop, _ _ _ clé IPSec iSCSI VDS, _ adresse IP VDS.

* Windows server 2003 : cette interface n’est pas prise en charge tant que Windows Server 2003 R2.

Objet port HBA

L’objet port HBA modélise une Fibre Channel Port d’adaptateur de bus hôte (HBA).

Utilisez la méthode IVdsServiceHba :: QueryHbaPorts pour déterminer les ports HBA connus du 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, _ _ État de VDS HBAPORT, _ indicateur de _ Vitesse _ VDS HBAPORT.
Structures associées VDS _ HBAPORT _ prop.

* Windows server 2003 : cette interface n’est pas prise en charge tant que Windows Server 2003 R2.

Modèle d’objet VDS

IVdsServiceLoader::LoadService

Chargement de VDS

IVdsService :: GetObject

Notifications VDS