Méthode IVdsPack ::AddDisk (vds.h)

Article
03/03/2024

[À 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 disque à un pack en ligne.

Syntaxe

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

Paramètres

[in] DiskId

GUID du disque.

[in] PartitionStyle

Le style peut être MBR ou GPT. Consultez l’énumération VDS_PARTITION_STYLE .

[in] bAsHotSpare

Si la valeur est true, VDS peut utiliser le disque comme disque de secours à chaud ; sinon, le disque ne peut pas être utilisé pour cette opération. Seuls les fournisseurs de matériel prennent en charge l’éparse à chaud.

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 disque a été ajouté avec succès.
VDS_E_NOT_AN_UNALLOCATED_DISK 0x80042418L	Le disque est brut.
VDS_E_OPERATION_DENIED 0x8004240AL	Le disque à ajouter est en cours de nettoyage.
VDS_E_PROVIDER_FAILURE 0x80042442L	Il y a une défaillance du fournisseur pendant l’opération.
VDS_E_NOT_SUPPORTED 0x80042400L	L’ajout d’un deuxième disque à un pack de base n’est pas pris en charge.
VDS_E_PACK_OFFLINE 0x80042444L	Le pack cible est inaccessible.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Le disque est introuvable.
VDS_E_DMADMIN_METHOD_CALL_FAILED 0x80042420L	Le service de gestionnaire de disques logiques (LDM) n’a pas pu exécuter une méthode.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Le cache du fournisseur dynamique est endommagé.

Remarques

VDS implémente cette méthode.

Cette méthode initialise un disque brut (un disque qui n’a pas de partitionnement défini) et l’ajoute au pack. Avant l’appel de cette méthode, le disque brut appartient au service VDS. Une fois cette méthode retournée, le disque appartient au fournisseur de base.

Pour annuler l’effet de cette méthode, c’est-à-dire supprimer le format de partitionnement et faire en sorte que le disque soit un disque brut appartenant au service VDS, utilisez la méthode IVdsAdvancedDisk ::Clean .

Vous ne pouvez pas utiliser AddDisk pour redéfinir le partitionnement sur un disque existant.

Si vous ajoutez un disque GPT à un pack de base, l’opération crée automatiquement une partition MSR sur le disque. Les appareils exécutant le système d’exploitation WinPE sont l’exception, car un administrateur peut préférer créer une partition ESP sur le disque. La partition ESP, si elle est présente, doit être la première partition sur le disque.

Si vous ajoutez le disque à un pack dynamique, l’opération ne crée pas de partition MSR.

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

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE

Partager via