Méthode IVdsVolume ::AddPlex (vds.h)

Article
03/08/2023

[À 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