MSFT_Partition Klasse
Stellt eine Partition auf einem Datenträger dar.
Die folgende Syntax ist eine Vereinfachung des Codes im Managed Object Format (MOF).
Syntax
class MSFT_Partition : MSFT_StorageObject
{
UInt32 DiskNumber;
UInt32 PartitionNumber;
Char16 DriveLetter;
String AccessPaths[];
UInt16 OperationalStatus;
UInt16 TransitionState;
UInt64 Size;
UInt16 MbrType;
String GptType;
String Guid;
Boolean IsReadOnly;
Boolean IsOffline;
Boolean IsSystem;
Boolean IsBoot;
Boolean IsActive;
Boolean IsHidden;
Boolean IsShadowCopy;
Boolean NoDefaultDriveLetter;
};
Member
Die MSFT_Partition-Klasse weist folgende Typen von Membern auf:
Methoden
Die MSFT_Partition Klasse weist diese Methoden auf.
| Methode | Beschreibung |
|---|---|
| AddAccessPath | Fügt der Partition einen Bereitstellungspfad oder eine Laufwerkbuchstabenzuweisung hinzu. |
| DeleteObject | Löscht die Partition und das entsprechende Volume. |
| GetAccessPaths | Ruft alle Bereitstellungspunkte und Laufwerkbuchstaben ab, die für den Zugriff auf die Partition verwendet werden können. |
| GetSupportedSize | Ruft die mindesten und maximalen Größen ab, in die die Größe der Partition mithilfe der Resize-Methode geändert werden kann. |
| Offline | Hebt die Partition offline auf, indem die Bereitstellung des zugeordneten Volumes aufgehoben wird (sofern vorhanden). |
| Online | Bringt die Partition online, indem das zugeordnete Volume (sofern vorhanden) bereitgestellt wird. |
| RemoveAccessPath | Entfernen Sie einen Zugriffspfad aus der Partition. |
| Resize | Ändert die Größe der Partition und jedes zugeordnete Dateisystemvolumes auf die größe, die durch den Parameter Size angegeben wird. |
| SetAttributes | Legt verschiedene Attribute und Eigenschaften der Partition fest. |
Eigenschaften
Die MSFT_Partition Klasse verfügt über diese Eigenschaften.
AccessPaths
Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt
Ein Array von Zeichenfolgen, die die verschiedenen Bereitstellungspunkte für die Partition enthalten. Diese Liste enthält zusätzlich zu bereitgestellten Ordnern Laufwerkbuchstaben.
DiskNumber
Datentyp: UInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: Erforderlich, ModelCorrespondence {"MSFT_Disk.Number"}
Die Nummer des Betriebssystems für den Datenträger, der diese Partition enthält. Datenträgernummern bleiben möglicherweise nicht unbedingt bei Neustarts gleich.
DriveLetter
Datentyp: Char16
Zugriffstyp: Schreibgeschützt
Der aktuell zugewiesene Laufwerkbuchstaben für die Partition. Diese Eigenschaft ist NULL , wenn kein Laufwerkbuchstaben zugewiesen wurde.
GptType
Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Der GPT-Typ der Partition. Diese Eigenschaft ist nur gültig, wenn die PartitionStyle-Eigenschaft des Datenträgers GPT ist und für alle anderen Partitionsstile NULL ist.
| Wert | Bedeutung |
|---|---|
| Systempartition c12a7328-f81f-11d2-ba4b-00a0c93ec93b | Eine EFI-Systempartition. |
| Microsoft Reserved e3c9e316-0b5c-4db8-817d-f92df00215ae | Eine reservierte Microsoft-Partition. |
| Grunddaten 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, bereitgestellte Ordner hosten (auch als Volume mount points bezeichnet) und durch Aufrufe von FindFirstVolume und FindNextVolume aufgezählt werden. |
| LDM-Metadaten 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3 | Eine LDM-Metadatenpartition (Logical Disk Manager) auf einem dynamischen Datenträger. |
| LDM Data 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. |
Guid
Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Die GPT-GUID der Partition. Diese Eigenschaft ist nur gültig, wenn die PartitionStyle-Eigenschaft des Datenträgers GPT ist und für alle anderen Partitionsstile NULL ist.
IsActive
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Wenn TRUE, ist die Partition aktiv und kann verwendet werden, um das System zu starten. Diese Eigenschaft ist nur gültig, wenn die PartitionStyle-Eigenschaft des Datenträgers MBR ist und für alle anderen Partitionsstile NULL ist.
IsBoot
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Wenn WAHR, ist die Partition die aktuelle Startpartition.
IsHidden
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Wenn WAHR, wird die Partition nicht vom Bereitstellungs-Manager erkannt. Daher empfängt die Partition keinen Laufwerkbuchstaben, empfängt keinen Volume-GUID-Pfad, hostet keine Volume-Bereitstellungspunkte und wird nicht durch Aufrufe von FindFirstVolume und FindNextVolume aufgezählt. Dadurch wird sichergestellt, dass Anwendungen wie z. B. Datenträgerentfragmentierung nicht auf die Partition zugreifen. Der Volumeschattenkopiedienst (Volume Shadow Copy Service, VSS) verwendet dieses Attribut für seine Schattenkopien.
IsOffline
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Wenn WAHR, ist diese Partition derzeit offline.
IsReadOnly
Datentyp: Boolescher Wert
Zugriffstyp: Schreibgeschützt
Wenn WAHR, ist dies eine schreibgeschützte Partition.
IsShadowCopy
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Wenn WAHR, ist die Partition eine Schattenkopie einer anderen Partition. Dieses Attribut wird von VSS verwendet. Dieses Attribut ist ein Hinweis auf treiberbasierte Dateisystemsoftware (z. B. Antivirenprogramme), um das Anfügen an das Volume zu vermeiden. Eine Anwendung kann dieses Attribut verwenden, um eine Schattenkopiepartition von einer Produktionspartition zu unterscheiden. Eine Anwendung, die eine schnelle Wiederherstellung durchführt, unterbricht beispielsweise einen virtuellen Schattenkopiedatenträger, indem die schreibgeschützten und ausgeblendeten Attribute und dieses Attribut gelöscht werden. Dieses Attribut wird festgelegt, wenn die Schattenkopie erstellt und gelöscht wird, wenn die Schattenkopie unterbrochen wird.
IsSystem
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Wenn WAHR, ist dies eine Systempartition.
MbrType
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Der MBR-Typ der Partition. Diese Eigenschaft ist nur gültig, wenn die PartitionStyle-Eigenschaft des Datenträgers MBR ist und für alle anderen Partitionsstile NULL ist.
FAT12 (1)
FAT16 (4)
Erweitert (5)
Groß (6)
WENNS (7)
FAT32 (12)
NoDefaultDriveLetter
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Wenn TRUE, weist das Betriebssystem keinen Laufwerkbuchstaben automatisch zu, wenn die Partition erkannt wird. Dies wird nur für GPT-Datenträger berücksichtigt und wird als FALSE für MBR-Datenträger angenommen. Dieses Attribut ist in SAN-Umgebungen (Storage Area Network) nützlich.
OperationalStatus
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Qualifizierer: Werte ( "Unbekannt", "Online", "No Media", "Failed", "Offline" ), ValueMap ( "0", "1", "3", "5", "4" )
Der Betriebsstatus der Partition.
PartitionNumber
Datentyp: UInt32
Zugriffstyp: Schreibgeschützt
Kennzeichner: Erforderlich
Die Nummer des Betriebssystems für die Partition. Die Sortierung basiert auf dem Offset der Partition relativ zu anderen Partitionen. Dies bedeutet, dass sich der Wert für diese Eigenschaft basierend auf der Partitionskonfiguration im Offsetbereich vor dieser Partition ändern kann.
Größe
Datentyp: UInt64
Zugriffstyp: Schreibgeschützt
Gesamtgröße der Partition, gemessen in Byte.
TransitionState
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Der Übergangszustand der Partition. Einer der folgenden Werte:
| Wert | Bedeutung |
|---|---|
| 0 | Dieser Wert ist für die Systemnutzung reserviert. |
| 1 | Die Partition ist stabil. Derzeit wird keine Konfigurationsaktivität ausgeführt. |
| 2 | Die Partition wird erweitert. |
| 3 | Die Partition wird abgeschrumpft. |
| 4 | Die Partition wird automatisch neu konfiguriert. |
| 8 | Die Partition wird erneut verschoben. |
Hinweise
Ab Windows 10: MSFT_Partition wird von MSFT_StorageObject abgeleitet.
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 |