IVdsAdvancedDisk2 ::ChangePartitionType, méthode (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.]

Modifie le type de partition sur le disque à un décalage d’octets spécifié.

Syntaxe

HRESULT ChangePartitionType(
  [in] ULONGLONG                        ullOffset,
  [in] BOOL                             bForce,
  [in] CHANGE_PARTITION_TYPE_PARAMETERS *para
);

Paramètres

[in] ullOffset

Décalage en octets de la partition à partir du début du disque. Ce décalage doit être le décalage du début d’une partition.

[in] bForce

Valeur booléenne qui indique si la modification sera forcée.

[in] para

Pointeur vers une structure CHANGE_PARTITION_TYPE_PARAMETERS qui contient le type de partition vers lequel la partition à l’emplacement spécifié par le paramètre ullOffset sera modifié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	Le type de partition a été modifié avec succès.
VDS_E_DEVICE_IN_USE 0x80042413L	La partition est en cours d’utilisation.
VDS_E_INTERNAL_ERROR 0x80042448L	Une erreur interne s’est produite. Pour plus d’informations, consultez le journal des événements.
VDS_E_INVALID_PARTITION_TYPE 0x80042565L	Le type de partition spécifié n’est pas valide pour cette opération.
VDS_E_NOT_SUPPORTED 0x80042400L	La modification du type de partition sur les disques dynamiques n’est pas prise en charge.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	La partition n’existe pas.
VDS_E_PARTITION_LDM 0x8004258DL	Cette opération n’est pas prise en charge sur les partitions LDM.
VDS_E_PARTITION_MSR 0x8004258CL	Cette opération n’est pas prise en charge sur les partitions MSR.
VDS_E_PARTITION_STYLE_MISMATCH 0x80042571L	Le style de partition spécifié ne correspond pas à celui du disque.

Remarques

Si une partition OEM est au format FAT ou FAT32, le type de partition ne change pas. S’il est mis en forme avec NTFS, le type de partition devient PARTITION_IFS (0x07). Pour plus d’informations sur les types de partitions, consultez CREATE_PARTITION_PARAMETERS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vds.h
Bibliothèque	Uuid.lib

Voir aussi

IVdsAdvancedDisk2

Partager via