PARTITION_INFORMATION_GPT-Struktur (winioctl.h)

Enthält GPT-Partitionsinformationen ( GUID-Partitionstabelle).

Syntax

typedef struct _PARTITION_INFORMATION_GPT {
  GUID    PartitionType;
  GUID    PartitionId;
  DWORD64 Attributes;
  WCHAR   Name[36];
} PARTITION_INFORMATION_GPT, *PPARTITION_INFORMATION_GPT;

Member

PartitionType

Eine GUID , die den Partitionstyp identifiziert.

Jeder Partitionstyp, den die EFI-Spezifikation unterstützt, wird durch eine eigene GUID identifiziert, die vom Entwickler der Partition veröffentlicht wird.

Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
Der Datenpartitionstyp, der von Windows erstellt und erkannt wird.

Nur Partitionen dieses Typs können Laufwerkbuchstaben zugewiesen werden, Volume-GUID-Pfade empfangen, Ordner gehostet werden (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.

PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
Es gibt keine Partition.

Dieser Wert kann für einfache und dynamische Datenträger festgelegt werden.

PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
Die Partition ist eine EFI-Systempartition.

Dieser Wert kann für einfache und dynamische Datenträger festgelegt werden.

PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
Die Partition ist eine reservierte Microsoft-Partition.

Dieser Wert kann für einfache und dynamische Datenträger festgelegt werden.

PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
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.

PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-3311714a69ad
Die Partition ist eine LDM-Datenpartition auf einem dynamischen Datenträger.

Dieser Wert kann nur für dynamische Datenträger festgelegt werden.

PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
Die Partition ist eine Microsoft-Wiederherstellungspartition.

Dieser Wert kann für einfache und dynamische Datenträger festgelegt werden.

PartitionId

Die GUID der Partition.

Attributes

Die EFI-Attribute (Extensible Firmware Interface) der Partition.

Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
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 HilfsprogrammDiskPart.exe verwenden, um Partitionsvorgänge wie das Löschen der Partition auszuführen. Da es sich bei der Partition jedoch nicht um ein Volume handelt, können Sie das HilfsprogrammDiskPart.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.

GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
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.

GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
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.

GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
Wenn dieses Attribut festgelegt ist, ist die Partition eine Schattenkopie einer anderen Partition.

VSS verwendet dieses Attribut. 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. Eine Anwendung, die eine schnelle Wiederherstellung durchführt, unterbricht z. B. eine Schattenkopie-LUN und löscht die schreibgeschützten und ausgeblendeten Attribute und dieses Attribut. 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.

GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
Wenn dieses Attribut festgelegt ist, ist die Partition schreibgeschützt.

Schreibvorgänge in die Partition schlagen fehl. IOCTL_DISK_IS_WRITABLE schlägt mit dem ERROR_WRITE_PROTECT Win32-Fehlercode fehl, was bewirkt, dass das Dateisystem schreibgeschützte Einbindungen bewirkt, wenn ein Dateisystem vorhanden ist.

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.

Name[36]

Eine Breitzeichenzeichenfolge, die die Partition beschreibt.

Hinweise

Das GPT-Partitionsformat ist für Datenträger erforderlich, die zum Starten von Computern verwendet werden, die EFI-Firmware (Extended Firmware Interface) verwenden. GPT-Datenträger können sich in x86-, x64- und Itanium-basierten Architekturen befinden.

Ab Windows Server 2003 mit SP1 wird GPT auf allen Windows-Plattformen unterstützt, nicht nur auf Plattformen, die EFI verwenden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winioctl.h (windows.h einschließen)

Weitere Informationen

Dateisystemerkennung

IOCTL_DISK_GET_PARTITION_INFO_EX

IOCTL_DISK_SET_PARTITION_INFO_EX

PARTITION_INFORMATION_EX