Partager via


Méthode IVdsVolume::D elete (vds.h)

[À 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 le volume et tous les plex, libérant les étendues.

Syntaxe

HRESULT Delete(
  [in] BOOL bForce
);

Paramètres

[in] bForce

Si la valeur est TRUE, VDS supprime le volume même s’il est en cours d’utilisation ; sinon, le volume n’est pas supprimé s’il est en cours d’utilisation.

Valeur retournée

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 de retour Description
S_OK
Les plexes ont été supprimés avec succès.

Remarques

Vous pouvez uniquement supprimer des volumes d’un pack en ligne. Utilisez la méthode IVdsPack::GetProperties pour vérifier que l’état du pack est VDS_PS_ONLINE.

Vous ne pouvez pas supprimer un volume qui se trouve sur un support amovible.

VDS démonte le système de fichiers avant de supprimer un volume, opération requise par FAT et FAT32, mais pas NTFS. En outre, VDS supprime tous les chemins d’accès au volume après avoir supprimé le volume lui-même. Si l’opération de démontage échoue et que bForce a la valeur true, VDS supprime le volume sans démonter. Les applications clientes de système de fichiers doivent gérer cette situation. Si le démontage réussit et que l’opération de suppression échoue, VDS tente de remonter le volume.

VDS empêche la suppression des volumes système et de démarrage actuels, ainsi que des volumes de pagefile, de crashdump et de mise en veille prolongée. Vous pouvez déplacer ou réinitialiser le crashdump et le pagefile. Le volume de mise en veille prolongée doit rester sur la partition de démarrage.

Windows Server 2003 : Les volumes crashdump et de mise en veille prolongée doivent rester sur la partition de démarrage.

Windows Server 2003 : Une fois le volume supprimé, VDS tente de supprimer les dossiers montés. Si cette opération échoue, La suppression retourne VDS_S_ACCESS_PATH_NOT_DELETED, même si le volume a été supprimé avec succès.

Configuration requise

   
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

IVdsPack::GetProperties

IVdsVolume

VDS_PACK_STATUS