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 |
|---|---|
|
Le plex a été supprimé avec succès. |
|
Le volume n’est pas accessible. |
|
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 |