Méthode IVdsVolumeMF2::FormatEx (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.]

Met en forme un volume de système de fichiers sur une partition.

Syntaxe

HRESULT FormatEx(
  [in]  LPWSTR    pwszFileSystemTypeName,
  [in]  USHORT    usFileSystemRevision,
  [in]  ULONG     ulDesiredUnitAllocationSize,
  [in]  LPWSTR    pwszLabel,
  [in]  BOOL      bForce,
  [in]  BOOL      bQuickFormat,
  [in]  BOOL      bEnableCompression,
  [out] IVdsAsync **ppAsync
);

Paramètres

[in] pwszFileSystemTypeName

Chaîne Unicode terminée par null contenant le nom du système de fichiers avec lequel mettre en forme le volume. Ce paramètre peut être NULL ou le nom d’un système de fichiers Windows. Les systèmes de fichiers suivants sont pris en charge : « NTFS », « FAT », « FAT32 », « UDF » et « EXFAT ». Si ce paramètre a la valeur NULL, le système de fichiers par défaut est utilisé. Pour plus d’informations, consultez VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG.

[in] usFileSystemRevision

Révision du système de fichiers, le cas échéant. Ce membre est exprimé sous la forme d’un nombre décimal codé binaire de 16 bits, où une virgule décimale est implicite entre les deuxième et troisième chiffres. Par exemple, une valeur de 0x0250 indique la révision 2.50.

[in] ulDesiredUnitAllocationSize

Taille de l’unité d’allocation pour le système de fichiers, en octets. La valeur doit être une puissance de 2. Si la valeur est 0, une unité d’allocation par défaut déterminée par le type de système de fichiers est utilisée. La plage d’unités d’allocation dépend du système de fichiers.

[in] pwszLabel

Chaîne Unicode terminée par null à affecter au nouveau système de fichiers. La taille maximale de l’étiquette dépend du système de fichiers.

[in] bForce

Boolean qui détermine si un format de système de fichiers est forcé, que la partition soit en cours d’utilisation ou non.

[in] bQuickFormat

Boolean qui détermine si un volume de système de fichiers est mis en forme rapidement. Un format rapide ne vérifie pas chaque secteur sur le volume.

[in] bEnableCompression

Boolean qui détermine si le volume du système de fichiers sera créé avec la compression activée.

Note Ce paramètre est ignoré si le système de fichiers n’est pas NTFS.

[out] ppAsync

Pointeur vers une interface IVdsAsync qui, une fois terminée, reçoit l’interface IVdsAsync pour surveiller et contrôler cette opération. Les appelants doivent libérer l’interface reçue lorsqu’ils en ont terminé.

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 0x000000000L	Le système de fichiers a été correctement mis en forme.
VDS_E_OPERATION_DENIED 0x8004240AL	L’opération est refusée si l’appelant tente de mettre en forme le système, le démarrage, le crashdump, la mise en veille prolongée ou le volume pagefile.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Le volume a échoué.
VDS_E_PACK_OFFLINE 0x80042444L	Le pack contenant le volume n’est pas accessible. Tous les volumes d’un pack hors connexion sont inaccessibles.
VDS_E_FS_NOT_DETERMINED 0x80042593L	Impossible de déterminer le système de fichiers par défaut.

En outre, l’interface IVdsAsync peut retourner les avertissements et codes d’erreur associés suivants :

Code/valeur de retour	Description
VDS_E_INCOMPATIBLE_FILE_SYSTEM 0x80042425L	Le système de fichiers n’est pas compatible.
VDS_E_INCOMPATIBLE_MEDIA 0x80042426L	Le média n’est pas compatible.
VDS_E_ACCESS_DENIED 0x80042427L	L’accès est refusé.
VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L	Le média est protégé en écriture.
VDS_E_BAD_LABEL 0x80042429L	L’étiquette n’est pas valide.
VDS_E_CANT_QUICK_FORMAT 0x8004242AL	Le volume ne peut pas être mis en forme rapidement.
VDS_E_IO_ERROR 0x8004242BL	Une erreur d’E/S s’est produite pendant le format.
VDS_E_VOLUME_TOO_SMALL 0x8004242CL	La taille du volume est trop petite pour être mise en forme.
VDS_E_VOLUME_TOO_BIG 0x8004242DL	La taille du volume est trop grande pour être mise en forme.
VDS_E_CLUSTER_SIZE_TOO_SMALL 0x8004242EL	La taille du cluster est trop petite pour permettre la mise en forme.
VDS_E_CLUSTER_SIZE_TOO_BIG 0x8004242FL	La taille du cluster est trop grande pour permettre la mise en forme.
VDS_E_CLUSTER_COUNT_BEYOND_32BITS 0x80042430L	Le nombre de clusters est trop grand pour être représenté sous la forme d’un entier de 32 bits.
VDS_S_VOLUME_COMPRESS_FAILED 0x00042443L	Le système de fichiers est mis en forme, mais pas compressé.
VDS_E_CANT_INVALIDATE_FVE 0x80042592L	Impossible de désactiver le chiffrement BitLocker pour le volume.

Remarques

Si une partition OEM est mise en forme en 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.

Si cette méthode est appelée pour un volume protégé par le chiffrement de volume complet BitLocker, le chiffrement BitLocker est désactivé pour le volume jusqu’à ce que l’utilisateur le réactive.

Pour plus d’informations sur les limites du système de fichiers, telles que la taille minimale et maximale de l’unité d’allocation (également appelée taille de cluster), consultez Référence technique NTFS et Référence technique FAT.

Configuration requise


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

IVdsVolumeMF2

Partager via