Méthode CreatePartition de la classe MSFT_Disk

Crée une partition sur un disque.

Syntaxe

UInt32 CreatePartition(
  [in]  UInt64  Size,
  [in]  Boolean UseMaximumSize,
  [in]  UInt64  Offset,
  [in]  UInt32  Alignment,
  [in]  Char16  DriveLetter,
  [in]  Boolean AssignDriveLetter,
  [in]  UInt16  MbrType,
  [in]  String  GptType,
  [in]  Boolean IsHidden,
  [in]  Boolean IsActive,
  [out] String  CreatedPartition,
  [out] String  ExtendedStatus
);

Paramètres

Taille [in]

Taille souhaitée, en octets, pour la partition. Elle doit être égale ou inférieure à la taille spécifiée par la propriété LargestFreeExtent du disque. Ce paramètre ne peut pas être utilisé avec UseMaximumSize.

UseMaximumSize [in]

Si la valeur est TRUE, la partition remplira la plus grande étendue libre sur le disque. Ce paramètre ne peut pas être utilisé avec le paramètre Size .

Offset [in]

Décalage de partition, en octets. Si le décalage n’est pas aligné et que le paramètre Alignment n’est pas spécifié, le décalage est arrondi à la limite d’alignement la plus proche, en fonction de la taille du disque sur lequel la partition est créée.

Alignement [in]

Alignement de la partition, en octets.

DriveLetter [in]

Lettre de lecteur à affecter à la partition au moment de la création. Ce paramètre ne peut pas être utilisé avec AssignDriveLetter. Si les deux paramètres sont spécifiés, une erreur paramètre non valide est retournée. Si la lettre de lecteur n’est pas disponible, la partition est créée, mais l’erreur « 42002 » est retournée.

AssignDriveLetter [in]

Si la valeur est TRUE, la lettre de lecteur disponible suivante est affectée à la partition créée. Si aucune autre lettre de lecteur n’est disponible, la partition est créée sans lettre de lecteur. Ce paramètre ne peut pas être utilisé avec DriveLetter. Si les deux paramètres sont spécifiés, une erreur paramètre non valide est retournée.

MbrType [in]

Spécifie le type de partition MBR. Ce paramètre ne peut être défini que si la propriété PartitionStyle du disque est MBR, sinon une erreur est retournée. La valeur par défaut de ce paramètre est Huge.

GptType [in]

Type GPT de la partition. Ce paramètre n’est valide que si la propriété PartitionStyle du disque est GPT, sinon une erreur est retournée. La valeur par défaut de ce paramètre est Données de base.

IsHidden [in]

Si la valeur est TRUE, la partition ne pourra pas recevoir d’affectation de lettre de lecteur, ni le gestionnaire de montage n’affectera un nom GUID de volume. La partition ne sera pas énumérée par les fonctions FindFirstVolume et FindNextVolume . La partition peut être ouverte par son nom de périphérique de volume associé (par exemple, « \\ ? GLOBALROOT\Device\HarddiskVolumeX »).

IsActive [in]

Si la valeur est TRUE, le bit actif MBR de la partition est défini et la partition devient démarrable. Ce paramètre est valide uniquement pour les disques MBR.

CreatedPartition [out]

Chaîne qui contient un objet MSFT_Partition incorporé qui représente la partition créée.

ExtendedStatus [out]

Chaîne qui 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)

Le disque est en cours d’utilisation (6)

Taille non prise en charge (4097)

Espace libre insuffisant (40000)

Accès refusé (40001)

Il n’y a pas suffisamment de ressources pour terminer l’opération. (40002)

Cache obsolète (40003)

Vous devez spécifier une taille à l’aide du paramètre Size ou UseMaximumSize. Vous ne pouvez spécifier qu’un seul de ces paramètres à la fois. (40005)

Le disque n’a pas été initialisé. (41000)

Le disque est en lecture seule. (41002)

Le disque est hors connexion. (41003)

La limite de partition du disque a été atteinte. (41004)

L’alignement de partition spécifié n’est pas valide. Il doit s’agir d’un multiple de la taille de secteur du disque. (41005)

Un paramètre n’est pas valide pour ce type de partition. (41006)

Le type de partition spécifié n’est pas valide. (41010)

Seuls les 2 premiers To sont utilisables sur les disques MBR. (41011)

Le décalage spécifié n’est pas valide. (41012)

Il n’y a aucun média dans l’appareil. (41015)

Le décalage spécifié n’est pas valide. (41016)

La disposition de partition spécifiée n’est pas valide. (41017)

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

Le chemin d’accès demandé est déjà utilisé. (42002)

Impossible d’attribuer des chemins d’accès aux partitions masquées. (42004)

Le chemin d’accès n’est pas valide. (42007)

Configuration requise

Voir aussi

MSFT_Disk