Méthode IVdsDiskPartitionMF2 ::FormatPartitionEx2 (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 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

Partager via