Partager via


Méthode IVdsDiskPartitionMF2 ::FormatPartitionEx2 (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 une partition OEM, ESP ou inconnue existante. Cette méthode est identique à la méthode IVdsDiskPartitionMF ::FormatPartition , sauf que les options de mise en forme sont spécifiées à l’aide du paramètre Options .

Syntaxe

HRESULT FormatPartitionEx2(
  [in]  ULONGLONG ullOffset,
  [in]  LPWSTR    pwszFileSystemTypeName,
  [in]  USHORT    usFileSystemRevision,
  [in]  ULONG     ulDesiredUnitAllocationSize,
  [in]  LPWSTR    pwszLabel,
  [in]  DWORD     Options,
  [out] IVdsAsync **ppAsync
);

Paramètres

[in] ullOffset

Décalage d’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] pwszFileSystemTypeName

Chaîne Unicode terminée par null contenant le nom du système de fichiers avec lequel mettre en forme la partition. Doit être NULL ou l’une des valeurs suivantes : « NTFS », « FAT », « FAT32 », « UDF » ou « EXFAT ». Si ce paramètre a la valeur NULL, une valeur par défaut est utilisée. 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é par binaire 16 bits, où une virgule décimale est impliquée entre le deuxième et le troisième chiffre. Par exemple, la valeur 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 contenant l’étiquette à affecter au nouveau système de fichiers pour la partition. La taille maximale des étiquettes dépend du système de fichiers.

[in] Options

Masque de bits de VDS_FORMAT_OPTION_FLAGS valeurs d’énumération qui spécifient des options de mise en forme.

[out] ppAsync

Pointeur vers une interface IVdsAsync qui, une fois l’exécution réussie, 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
Le volume a été partitionné avec succès.
VDS_E_BAD_PROVIDER_DATA
0x80042441L
Un fournisseur a retourné des données incorrectes.
VDS_E_DISK_REMOVEABLE
0x8004255AL
L’opération n’est pas prise en charge sur un support amovible.
VDS_E_FS_NOT_DETERMINED
0x80042593L
Impossible de déterminer le système de fichiers par défaut.
VDS_E_MISSING_DISK
0x80042454L
Le disque est manquant.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
La partition n’existe pas.
VDS_E_PARTITION_NOT_OEM
0x8004256FL
L’opération n’est pas prise en charge sur les partitions non OEM.
 

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

Code/valeur de retour Description
VDS_S_VOLUME_COMPRESS_FAILED
0x00042443L
Le système de fichiers est mis en forme, mais pas compressé.
VDS_E_ACCESS_DENIED
0x80042427L
L’accès est refusé.
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_CLUSTER_COUNT_BEYOND_32BITS
0x80042430L
Le nombre de clusters est trop grand pour être représenté sous la forme d’un entier 32 bits.
VDS_E_CLUSTER_SIZE_TOO_BIG
0x8004242FL
La taille du cluster est trop grande pour permettre la 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_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_IO_ERROR
0x8004242BL
Une erreur d’E/S s’est produite pendant le format.
VDS_E_MEDIA_WRITE_PROTECTED
0x80042428L
Le média est protégé en écriture.
VDS_E_VOLUME_TOO_BIG
0x8004242DL
La taille du volume est trop grande pour être mise en forme.
VDS_E_VOLUME_TOO_SMALL
0x8004242CL
La taille du volume est trop petite pour être mise en forme.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vds.h

Voir aussi

IVdsDiskPartitionMF2

VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG

VDS_FORMAT_OPTION_FLAGS