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

  • Article

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