Méthode IVdsService ::CleanupObsoleteMountPoints (vds.h)

  • 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.]

Supprime les chemins d’accès en mode utilisateur et les dossiers montés pour les volumes qui n’existent plus.

Syntaxe

HRESULT CleanupObsoleteMountPoints();

Valeur de retour

Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.

Code/valeur de retour Description
S_OK
 Les chemins d’accès en mode utilisateur obsolètes et les dossiers montés ont été supprimés avec succès.
VDS_E_INITIALIZED_FAILED
0x80042401L
 Échec de l’initialisation de VDS. Si une application appelle cette méthode avant la fin de l’initialisation du service, la méthode est bloquée jusqu’à la fin de l’initialisation. Si l’initialisation échoue, cette erreur est retournée.

Remarques

Par défaut, le Registre conserve les informations de mappage de lettres de lecteur pour les volumes désinstallés. Si le disque qui contient le volume est supprimé de l’ordinateur, l’entrée de Registre est conservée, de sorte que si le disque et le volume retournent sur le même ordinateur, le volume reçoit la même lettre de lecteur. Si le disque est déplacé vers un nouvel ordinateur, les entrées du Registre ne se déplacent pas avec lui, de sorte que le volume peut recevoir une lettre de lecteur et un GUID de volume différents.

La méthode CleanupObsoleteMountPoints supprime ces entrées de Registre. Trois types d’entrées de Registre sont supprimés :

  • Si le volume n’a pas de lettre de lecteur ou de GUID de volume, il a une entrée de Registre « aucune lettre de lecteur », qui est supprimée par cette méthode.
  • Sinon, le volume a des entrées de Registre pour un GUID de volume et éventuellement une lettre de lecteur. Les deux sont supprimés par cette méthode.
En outre, si le volume contient des dossiers montés, CleanupObsoleteMountPoints les supprime. Par exemple, si Volume1 sur Disk1 est supprimé et que Volume1 est monté en tant que x :\MountVolume1 sur Disk2, le dossier \MountVolume1 sur Disk2 est également supprimé.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vds.h
Bibliothèque Uuid.lib

Voir aussi

IVdsService