Partager via


Méthode IVdsVolume ::RemovePlex (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 un ou plusieurs plex spécifiés du volume actuel, libérant les étendues.

Syntaxe

HRESULT RemovePlex(
  [in]  VDS_OBJECT_ID plexId,
  [out] IVdsAsync     **ppAsync
);

Paramètres

[in] plexId

GUID du plex à supprimer.

[out] ppAsync

Adresse d’un pointeur d’interface IVdsAsync , que VDS initialise au retour. Les appelants doivent libérer l’interface. Utilisez ce pointeur pour annuler, attendre ou interroger le status de l’opération.

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/valeur de retour Description
S_OK
Le plex a été supprimé avec succès.
VDS_E_VOLUME_NOT_ONLINE
0x8004243DL
Le volume n’est pas accessible.
VDS_E_VOLUME_NOT_A_MIRROR
0x80042445L
Le volume n’est pas un miroir.

Remarques

Cette opération ne peut pas supprimer le dernier plex d’un volume. Utilisez plutôt la méthode IVdsVolume ::D elete pour supprimer le dernier volume restant (le seul plex). Cette méthode n’est pas valide pour les volumes de base, qui ont exactement un plex.

VDS ne démonte pas le volume lorsqu’il supprime un plex.

Les implémenteurs doivent retourner un pointeur vers l’interface IVdsAsync pour cette méthode, que l’appel lance ou non une opération asynchrone.

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

IVdsAsync

IVdsVolume

IVdsVolume ::D elete