Partager via


Méthode IVdsVolume ::AddPlex (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.]

Ajoute un volume sous forme de plex au volume actuel.

Syntaxe

HRESULT AddPlex(
  [in]  VDS_OBJECT_ID VolumeId,
  [out] IVdsAsync     **ppAsync
);

Paramètres

[in] VolumeId

GUID du volume à ajouter en tant que plex.

[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é ajouté avec succès.
VDS_S_GPT_BOOT_MIRRORED_TO_MBR
0x80042469L
Le volume de démarrage sur un disque GPT a été mis en miroir sur un disque MBR. Le nouveau plex ne peut pas être utilisé pour démarrer l’ordinateur.
VDS_E_VOLUME_NOT_ONLINE
0x8004243DL
Le volume n’est pas accessible.
VDS_E_VOLUME_NOT_HEALTHY
0x8004243EL
Le volume échoue ou a échoué.
VDS_E_VOLUME_SPANS_DISKS
0x8004243FL
Le volume s’étend sur plusieurs disques.
VDS_E_REQUIRES_CONTIGUOUS_DISK_SPACE
0x80042440L
Le volume se compose de plusieurs étendues.
VDS_E_INVALID_OPERATION
0x80042415L
Le volume source est inférieur au volume cible. Si le volume source est supérieur au volume cible, le volume cible reste de la même taille et l’opération réussit.

Remarques

Cette opération n’est pas valide pour les volumes de base, qui ont exactement un plex.

Utilisez cette méthode pour ajouter un volume en tant que plex à un autre volume. Par exemple, un appelant peut créer un volume (volume B), spécifier le volume B comme nouveau plex sur un volume existant (volume A), puis supprimer le volume B. Le nouveau plex du volume A occupe les mêmes étendues de disque que le volume B.

Note VDS tente d’utiliser les mêmes étendues, mais ne peut pas garantir ce comportement.
 
Les appelants peuvent ajouter un volume mis en miroir en tant que nouveau plex à un autre volume. Le volume résultant contient des plexes en nombre égal à la somme des volumes d’origine.

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

Objet Volume Plex