Méthode de formatage de la classe MSFT_Volume

Formate le volume.

Syntaxe

UInt32 Format(
  [in]  String  FileSystem,
  [in]  String  FileSystemLabel,
  [in]  UInt32  AllocationUnitSize,
  [in]  Boolean Full,
  [in]  Boolean Force,
  [in]  Boolean Compress,
  [in]  Boolean ShortFileNameSupport,
  [in]  Boolean SetIntegrityStreams,
  [in]  Boolean UseLargeFRS,
  [in]  Boolean DisableHeatGathering,
  [out] String  FormattedVolume,
  [out] String  ExtendedStatus
);

Paramètres

FileSystem [in]

Système de fichiers à appliquer au volume. Celui-ci peut avoir l'une des valeurs suivantes :

• « ExFAT »
• « FAT »
• « FAT32 »
• « NTFS »
• « ReFS »

FileSystemLabel [in]

Étiquette du système de fichiers pour le volume.

AllocationUnitSize [in]

Taille de l’unité d’allocation, en octets.

Full [in]

TRUE pour un formatage complet ou FALSE pour un formatage rapide.

Force [in]

TRUE pour forcer l’opération de formatage ; sinon, FALSE.

Compress [in]

TRUE pour compresser le volume ; sinon, FALSE. Ne pas définir si FileSystem est défini sur ReFS.

ShortFileNameSupport [in]

TRUE si le volume doit prendre en charge les noms courts ; sinon, FALSE. Ne pas définir si FileSystem est défini sur ReFS.

SetIntegrityStreams [in]

TRUE pour définir des flux d’intégrité. Ne pas définir sauf si FileSystem est défini sur ReFS.

UseLargeFRS [in]

TRUE pour utiliser des FRS volumineux ; sinon, FALSE. Ne pas définir si FileSystem est défini sur ReFS.

DisableHeatGathering [in]

TRUE pour désactiver la collecte de chaleur ; sinon, FALSE.

FormattedVolume [out]

Reçoit un objet MSFT_Volume qui représente le volume formaté.

ExtendedStatus [out]

Contient un objet MSFT_StorageExtendedStatus incorporé.

Ce paramètre permet au fournisseur de stockage de renvoyer les informations d’erreur étendues (spécifiques à l’implémentation).

Valeur retournée

Opération réussie (0)

Non supporté (1)

Erreur non spécifiée (2)

Délai d’expiration (3)

Échec (4)

Paramètre non valide (5)

Cette commande n’est pas prise en charge sur x86 s’exécutant dans un environnement x64. (7)

Accès refusé (40001)

Une erreur E/S inattendue s’est produite (40004)

L’objet spécifié est géré par le composant Clustering de basculement Microsoft. Le disque doit être en mode maintenance du cluster et l’état de la ressource de cluster doit être en ligne pour effectuer cette opération. (40018)

L’opération n’est pas autorisée sur une partition système ou critique. (42010)

La taille de cluster spécifiée n’est pas valide (43000)

Le système de fichiers spécifié n’est pas pris en charge (43001)

Le volume ne peut pas être formaté rapidement (43002)

Le nombre de clusters dépasse 32 bits (43003)

La version UDF spécifiée n’est pas prise en charge (43004)

La taille du cluster doit être un multiple de la taille du secteur physique du disque (43005)

Impossible d’effectuer l’opération demandée lorsque le lecteur est en lecture seule (43006)

Spécifications

Voir aussi

MSFT_Volume