Partager via


Méthode IVdsVolumeMF2::FormatEx (vds.h)

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