CREATE_PARTITION_PARAMETERS Struktur (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]
Definiert die Partitionsparameter eines Partitionsstils.
Syntax
typedef struct _CREATE_PARTITION_PARAMETERS {
VDS_PARTITION_STYLE style;
union {
struct {
BYTE partitionType;
BOOLEAN bootIndicator;
} MbrPartInfo;
struct {
GUID partitionType;
GUID partitionId;
ULONGLONG attributes;
WCHAR name[36];
} GptPartInfo;
};
} CREATE_PARTITION_PARAMETERS;
Member
style
MbrPartInfo
Parameter für einen MBR-Datenträger (Master Boot Record). Wird verwendet, wenn der StilVDS_PST_MBR ist.
MbrPartInfo.partitionType
Gibt den systemdefinierte MBR-Partitionstyp an. Es sind folgende Werte möglich:
MbrPartInfo.bootIndicator
Bei TRUE ist die Partition aktiv und kann gestartet werden. Andernfalls kann die Partition nicht zum Starten des Systems verwendet werden.
GptPartInfo
Parameter für einen GPT-Datenträger (GUID Partition Table). Wird verwendet, wenn der StilVDS_PST_GPT ist.
GptPartInfo.partitionType
Eine GUID des Partitionstyps.
| Wert | Bedeutung |
|---|---|
|
Es gibt keine Partition.
Dieses Attribut kann für einfache und dynamische Datenträger festgelegt werden. |
|
Die Partition ist eine EFI-Systempartition.
Dieses Attribut kann für einfache und dynamische Datenträger festgelegt werden. |
|
Die Partition ist eine reservierte Microsoft-Partition.
Dieses Attribut kann für einfache und dynamische Datenträger festgelegt werden. |
|
Der Datenpartitionstyp, 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. Dieser Wert kann mit einer Ausnahme nur für Basisdatenträger festgelegt werden. Wenn sowohl PARTITION_BASIC_DATA_GUID als auch GPT_ATTRIBUTE_PLATFORM_REQUIRED für eine Partition auf einem Basisdatenträger festgelegt sind, der anschließend in einen dynamischen Datenträger konvertiert wird, bleibt die Partition eine Einfache Partition, auch wenn der Rest des Datenträgers ein dynamischer Datenträger ist. Dies liegt daran, dass die Partition als OEM-Partition auf einem GPT-Datenträger gilt. |
|
Die Partition ist eine LDM-Metadatenpartition (Logical Disk Manager) auf einem dynamischen Datenträger.
Dieser Wert kann nur für dynamische Datenträger festgelegt werden. |
|
Die Partition ist eine LDM-Datenpartition auf einem dynamischen Datenträger.
Dieser Wert kann nur für dynamische Datenträger festgelegt werden. |
|
Die Partition ist eine Microsoft-Wiederherstellungspartition.
Dieses Attribut kann für einfache und dynamische Datenträger festgelegt werden. |
GptPartInfo.partitionId
Gibt die ID der Partition an. Wenn bei der Erstellung auf GUID_NULL (0) festgelegt ist, wird ein eindeutiger Wert generiert.
GptPartInfo.attributes
Attribute der Partition. Dies kann einen der folgenden Werte annehmen:
| Wert | Bedeutung |
|---|---|
|
Wenn dieses Attribut festgelegt ist, wird die Partition von einem Computer benötigt, um ordnungsgemäß zu funktionieren.
Dieses Attribut muss beispielsweise für OEM-Partitionen festgelegt werden. Wenn dieses Attribut festgelegt ist, können Sie das Hilfsprogramm DiskPart.exe verwenden, um Partitionsvorgänge wie das Löschen der Partition auszuführen. Da die Partition jedoch kein Volume ist, können Sie das Hilfsprogramm DiskPart.exe nicht verwenden, um Volumevorgänge für die Partition auszuführen. Dieses Attribut kann für einfache und dynamische Datenträger festgelegt werden. Wenn sie für eine Partition auf einem Basisdatenträger festgelegt ist und der Datenträger in einen dynamischen Datenträger konvertiert wird, bleibt die Partition eine Einfache Partition, auch wenn der Rest des Datenträgers ein dynamischer Datenträger ist. Dies liegt daran, dass die Partition als OEM-Partition auf einem GPT-Datenträger gilt. |
|
Wenn dieses Attribut festgelegt ist, empfängt die Partition standardmäßig keinen Laufwerkbuchstaben, wenn der Datenträger auf einen anderen Computer verschoben wird oder wenn der Datenträger zum ersten Mal von einem Computer erkannt wird.
Dieses Attribut ist in SAN-Umgebungen (Storage Area Network) hilfreich. Trotz seines Namens kann dieses Attribut für einfache und dynamische Datenträger festgelegt werden. |
|
Wenn dieses Attribut festgelegt ist, wird die Partition vom Einbindungs-Manager nicht erkannt.
Daher empfängt die Partition keinen Laufwerkbuchstaben, keinen Volume-GUID-Pfad, hostet keine eingebundenen Ordner (auch als Volumeeinbindungspunkte bezeichnet) und wird nicht durch Aufrufe von FindFirstVolume und FindNextVolume aufgezählt. Dadurch wird sichergestellt, dass Anwendungen wie die Datenträgerentfragmentierung nicht auf die Partition zugreifen. Der Volumeschattenkopiedienst (Volume Shadow Copy Service, VSS) verwendet dieses Attribut. Trotz seines Namens kann dieses Attribut für einfache und dynamische Datenträger festgelegt werden. |
|
Wenn dieses Attribut festgelegt ist, ist die Partition eine Schattenkopie einer anderen Partition.
Dieses Attribut wird vom Volume Shadow Copy-Dienst (VSS) verwendet. Dieses Attribut ist ein Hinweis auf dateisystemfiltertreiberbasierte Software (z. B. Antivirenprogramme), um das Anfügen an das Volume zu vermeiden. Eine Anwendung kann das -Attribut verwenden, um ein Schattenkopievolume von einem Produktionsvolume zu unterscheiden. Beispielsweise unterbricht eine Anwendung, die eine schnelle Wiederherstellung durchführt, eine Schattenkopie-LUN, indem sie die schreibgeschützten und ausgeblendeten Attribute und dieses Attribut löscht. Dieses Attribut wird festgelegt, wenn die Schattenkopie erstellt wird, und gelöscht, wenn die Schattenkopie unterbrochen wird. Trotz seines Namens kann dieses Attribut für einfache und dynamische Datenträger festgelegt werden. Windows Server 2003: Dieses Attribut wird vor Windows Server 2003 mit SP1 nicht unterstützt. |
|
Wenn dieses Attribut festgelegt ist, ist die Partition schreibgeschützt.
Alle Anforderungen zum Schreiben in die Partition schlagen fehl. VSS verwendet dieses Attribut. Legen Sie dieses Attribut nicht für dynamische Datenträger fest. Das Festlegen kann E/A-Fehler verursachen und verhindern, dass das Dateisystem ordnungsgemäß eingebunden wird. |
GptPartInfo.name[36]
Mit Null endende Unicode-Zeichenfolge, die den Namen der Partition angibt.
Hinweise
Die IVdsAdvancedDisk::CreatePartition-Methode übergibt diese Struktur als Argument, um einen Satz von Parametern anzugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | vds.h |