CreatePartition-Methode der MSFT_Disk-Klasse
Erstellt eine Partition auf einem Datenträger.
Syntax
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
);
Parameter
Größe [in]
Die gewünschte Größe in Bytes für die Partition. Diese muss gleich oder kleiner als die größe sein, die von der LargestFreeExtent-Eigenschaft des Datenträgers angegeben wird. Dieser Parameter kann nicht mit UseMaximumSize verwendet werden.
UseMaximumSize [in]
Bei TRUE füllt die Partition die größte freie Erweiterung auf dem Datenträger aus. Dieser Parameter kann nicht mit dem Parameter Size verwendet werden.
Offset [in]
Der Partitionsoffset in Bytes. Wenn der Offset nicht ausgerichtet ist und der Alignment-Parameter nicht angegeben ist, wird der Offset je nach Größe des Datenträgers, auf dem die Partition erstellt wird, auf die nächstgelegene Ausrichtungsgrenze aufgerundet oder heruntergerundet.
Ausrichtung [in]
Die Ausrichtung der Partition in Bytes.
DriveLetter [in]
Der Laufwerkbuchstabe, der der Partition zum Zeitpunkt der Erstellung zugewiesen werden soll. Dieser Parameter kann nicht mit AssignDriveLetter verwendet werden. Wenn beide Parameter angegeben sind, wird ein Ungültiger Parameterfehler zurückgegeben. Wenn der Laufwerkbuchstabe nicht verfügbar ist, wird die Partition erstellt, aber der Fehler "42002" wird zurückgegeben.
AssignDriveLetter [in]
Bei TRUE wird der nächste verfügbare Laufwerkbuchstabe der erstellten Partition zugewiesen. Wenn keine laufwerksbuchstaben mehr verfügbar sind, wird die Partition ohne Laufwerkbuchstaben erstellt. Dieser Parameter kann nicht mit DriveLetter verwendet werden. Wenn beide Parameter angegeben sind, wird ein Ungültiger Parameterfehler zurückgegeben.
MbrType [in]
Gibt den MBR-Partitionstyp an. Dieser Parameter kann nur festgelegt werden, wenn die PartitionStyle-Eigenschaft des Datenträgers MBR ist. Andernfalls wird ein Fehler zurückgegeben. Der Standardwert dieses Parameters ist Huge.
| Wert | Bedeutung |
|---|---|
| FAT12 1 | Dies ist eine FAT12-Dateisystempartition. |
| FAT16 4 | Dies ist eine FAT16-Dateisystempartition. |
| Erweitert 5 | Dies ist eine erweiterte Partition. |
| Riesige 6 | Eine riesige Partition. Dieser Wert gibt an, dass auf der Partition kein Windows-Dateisystem vorhanden ist. Verwenden Sie diesen Wert beim Erstellen eines logischen Volumes. |
| IFS 7 | Eine NTFS- oder ExFAT-Partition. |
| FAT32 12 | Eine FAT32-Partition. |
GptType [in]
Der GPT-Typ der Partition. Dieser Parameter ist nur gültig, wenn die PartitionStyle-Eigenschaft des Datenträgers GPT ist. Andernfalls wird ein Fehler zurückgegeben. Der Standardwert für diesen Parameter ist Basic data.
| Wert | Bedeutung |
|---|---|
| Systempartition c12a7328-f81f-11d2-ba4b-00a0c93ec93b | Eine EFI-Systempartition. |
| Microsoft Reserved e3c9e316-0b5c-4db8-817d-f92df00215ae | Eine reservierte Microsoft-Partition. |
| Basisdaten ebd0a0a2-b9e5-4433-87c0-68b6b72699c7 | Eine grundlegende Datenpartition. Dies ist der Datentyp, der von Windows erstellt und erkannt wird. Nur Partitionen dieses Typs können Laufwerkbuchstaben zugewiesen werden, Volume-GUID-Pfade empfangen, eingebundene Ordner hosten (auch als Volumeeinbindungspunkte bezeichnet) und durch Aufrufe von FindFirstVolume und FindNextVolume aufgezählt werden. |
| LDM Metadata 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3 | Eine LDM-Metadatenpartition (Logical Disk Manager) auf einem dynamischen Datenträger. |
| LDM-Daten af9b60a0-1431-4f62-bc68-3311714a69ad | Die Partition ist eine LDM-Datenpartition auf einem dynamischen Datenträger. |
| Microsoft Recovery de94bba4-06d1-4d40-a16a-bfd50179d6ac | Eine Microsoft-Wiederherstellungspartition. |
IsHidden [in]
Bei TRUE kann die Partition keine Laufwerkbuchstabenzuweisung empfangen, und der Einbindungs-Manager weist auch keinen Volume-GUID-Namen zu. Die Partition wird nicht von den Funktionen FindFirstVolume und FindNextVolume aufgelistet. Die Partition kann durch den zugehörigen Volumegerätenamen geöffnet werden (z. B. "\\?" GLOBALROOT\Device\HarddiskVolumeX").
IsActive [in]
Bei TRUE wird das aktive MBR-Bit der Partition festgelegt, und die Partition kann gestartet werden. Dieser Parameter ist nur für MBR-Datenträger gültig.
CreatedPartition [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_Partition -Objekt enthält, das die erstellte Partition darstellt.
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.
Dieser Parameter ermöglicht es dem Speicheranbieter, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.
Rückgabewert
Erfolg (0)
Nicht unterstützt (1)
Nicht angegebener Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
Datenträger wird verwendet (6)
Größe nicht unterstützt (4097)
Nicht genügend freier Speicherplatz (40000)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Veralteter Cache (40003)
Sie müssen eine Größe angeben, indem Sie entweder den Parameter Size oder UseMaximumSize verwenden. Sie können jeweils nur einen dieser Parameter angeben. (40005)
Der Datenträger wurde nicht initialisiert. (41000)
Der Datenträger ist schreibgeschützter Datenträger. (41002)
Der Datenträger ist offline. (41003)
Das Partitionslimit des Datenträgers wurde erreicht. (41004)
Die angegebene Partitionsausrichtung ist ungültig. Es muss ein Vielfaches der Sektorgröße des Datenträgers sein. (41005)
Ein Parameter ist für diesen Partitionstyp ungültig. (41006)
Der angegebene Partitionstyp ist ungültig. (41010)
Nur die ersten 2 TB können auf MBR-Datenträgern verwendet werden. (41011)
Der angegebene Offset ist ungültig. (41012)
Das Gerät enthält keine Medien. (41015)
Der angegebene Offset ist ungültig. (41016)
Das angegebene Partitionslayout ist ungültig. (41017)
Das angegebene Objekt wird von der Komponente Microsoft-Failoverclustering verwaltet. Der Datenträger muss sich im Clusterwartungsmodus befinden, und die Clusterressource status muss online sein, um diesen Vorgang auszuführen. (41018)
Der angeforderte Zugriffspfad wird bereits verwendet. (42002)
Zugriffspfade zu ausgeblendeten Partitionen können nicht zugewiesen werden. (42004)
Der Zugriffspfad ist ungültig. (42007)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |