CHANGE_ATTRIBUTES_PARAMETERS-Struktur (vds.h)

Artikel
03/08/2023

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]

Definiert die Partitionsparameter eines Partitionsstils.

Syntax

typedef struct _CHANGE_ATTRIBUTES_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      ULONGLONG attributes;
    } GptPartInfo;
  };
} CHANGE_ATTRIBUTES_PARAMETERS;

Member

style

Bestimmt die Partitionsparameter. Unterstützte Werte sind VDS_PST_MBR oder VDS_PST_GPT.

MbrPartInfo

Wird verwendet, wenn der StilVDS_PST_MBR ist. Parameter für einen MBR-Datenträger (Master Boot Record).

MbrPartInfo.bootIndicator

Bei TRUE ist die Partition aktiv und kann gestartet werden. Andernfalls kann die Partition nicht zum Starten des Systems verwendet werden.

GptPartInfo

Wird verwendet, wenn der StilVDS_PST_GPT ist. Parameter für einen GPT-Datenträger (GUID Partition Table).

GptPartInfo.attributes

Attribute der Partition. Dies kann einen der folgenden Werte annehmen:

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 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.
GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER 0x8000000000000000	Wenn dieses Attribut festgelegt ist, erhält die Partition standardmäßig keinen Laufwerkbuchstaben, wenn der Datenträger auf einen anderen Computer verschoben wird oder der Datenträger zum ersten Mal von einem Computer angezeigt wird. Dieses Attribut ist in SAN-Umgebungen nützlich. 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. Dieses Attribut wird vom Volume Shadow Copy-Dienst (VSS) verwendet. Dieses Attribut ist ein Hinweis auf dateisystemfiltertreiberbasierte Software (z. B. Antivirenprogramme), um eine Anfügung 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 LuN für Schattenkopien, indem die schreibgeschützten und ausgeblendeten Attribute und dieses Attribut deaktiviert werden. 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. Alle Anforderungen zum Schreiben in die Partition schlagen fehl. IOCTL_DISK_IS_WRITABLE schlägt mit dem ERROR_WRITE_PROTECT Win32-Fehlercode fehl, wodurch das Dateisystem schreibgeschützt eingebunden wird, 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.

Hinweise

Die IVdsAdvancedDisk::ChangeAttributes-Methode verwendet diese Struktur als Parameter.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	vds.h

Weitere Informationen

IVdsAdvancedDisk::ChangeAttributes

VDS-Strukturen

Freigeben über