Méthode de format de la classe MSFT_Volume

  • Article

Met en forme 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 format complet, ou FALSE pour un format rapide.

Forcer [in]

TRUE pour forcer l’opération de mise en forme ; sinon, FALSE.

Compresser [in]

TRUE pour compresser le volume ; sinon, FALSE. Laissez non défini si FileSystem est défini sur ReFS .

ShortFileNameSupport [in]

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

SetIntegrityStreams [in]

TRUE pour définir des flux d’intégrité. Laissez non défini, sauf si FileSystem est défini sur ReFS .

UseLargeFRS [in]

TRUE pour utiliser un FRS volumineux ; sinon, FALSE. Laissez non défini 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 mis en forme.

ExtendedStatus [out]

Contient un objet MSFT_StorageExtendedStatus incorporé.

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

Valeur retournée

Réussite (0)

Non pris en charge (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 exécuté dans un environnement x64. (7)

Accès refusé (40001)

Une erreur d’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 la ressource de cluster status 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 mis en forme rapidement (43002)

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

La version de la fonction 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)

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Espace de noms Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

Voir aussi

MSFT_Volume