Méthode IVdsAdvancedDisk ::D eletePartition (vds.h)

Article
03/13/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.]

Supprime une partition d’un disque de base.

Syntaxe

HRESULT DeletePartition(
  [in] ULONGLONG ullOffset,
  [in] BOOL      bForce,
  [in] BOOL      bForceProtected
);

Paramètres

[in] ullOffset

Décalage de partition.

[in] bForce

Si ce paramètre est défini sur TRUE, VDS supprime toutes les partitions de manière inconditionnelle (à l’exception de OEM, ESP ou MSR). Si elle est définie sur FALSE, l’opération échoue si la partition est en cours d’utilisation. Une partition est considérée comme étant en cours d’utilisation si les appels pour verrouiller ou démonter le volume échouent.

[in] bForceProtected

Si ce paramètre a la valeur TRUE, VDS supprime toutes les partitions protégées (y compris OEM, ESP et MSR) de manière inconditionnelle. S’il est défini sur FALSE, l’opération échoue si la partition est protégée.

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	La partition a été supprimée avec succès.
VDS_E_INVALID_OPERATION 0x80042415L	Le média ne prend pas en charge cette opération. Par exemple, vous ne pouvez pas supprimer une partition sur un CD-ROM.
VDS_E_NOT_SUPPORTED 0x80042400L	Cette opération n’est pas prise en charge sur les disques dynamiques.
VDS_E_PARTITION_NOT_EMPTY 0x80042408L	La partition étendue n’est pas vide.
VDS_E_BAD_PROVIDER_DATA 0x80042441L	Cette valeur indique une erreur de fournisseur. L’opération est abandonnée.
VDS_E_DEVICE_IN_USE 0x80042413L	La partition est en cours d’utilisation.
VDS_S_ACCESS_PATH_NOT_DELETED 0x00044244L	La partition a été supprimée avec succès, mais VDS n’a pas pu supprimer les chemins d’accès.
VDS_S_UPDATE_BOOTFILE_FAILED 0x00042434L	La partition a été supprimée avec succès, mais VDS n’a pas pu mettre à jour les options de démarrage dans le magasin de données de configuration de démarrage (BCD). Windows Server 2003 : Les options de démarrage sont stockées dans le fichier boot.ini sur un système x86 ou x64 ou nvRAM sur un système Itanium.

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

Objet Disk

IVdsAdvancedDisk

Partager via