IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

Löscht alle hardwarebasierten Snapshotinformationen (Volume Shadow Copy Service, VSS) vom Datenträger. Eine Momentaufnahme wird auch als Schattenkopie bezeichnet. Diese Anforderung ist in Windows Vista und höheren Versionen der Windows-Betriebssysteme verfügbar. Der Aufrufer muss unter IRQL = PASSIVE_LEVEL ausgeführt werden.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Nichts.

Eingabepufferlänge

Nichts.

Ausgabepuffer

Nichts.

Länge des Ausgabepuffers

Nichts.

Statusblock

Das Information Member ist auf Null festgelegt. Der Status- Member ist auf STATUS_SUCCESS festgelegt, wenn der Vorgang erfolgreich war. Andernfalls wird der Status Member auf den entsprechenden Fehlercode festgelegt.

Bemerkungen

Dieser E/A-Steuerungscode kann entweder von einem Kernelmodustreiber oder einer Benutzermodusanwendung ausgegeben werden. Wenn dieser E/A-Steuerungscode von einem Kernelmodustreiber ausgegeben wird, stellt der Aufrufer ein I/O-Anforderungspaket (IRP) bereit, das eine IO_STATUS_BLOCK Datenstruktur enthält. Diese Datenstruktur wird verwendet, um Fehlerinformationen an den Aufrufer zurückzugeben. Wenn dieser E/A-Steuerelementcode von einer Benutzermodusanwendung mit der DeviceIocontrol Routine ausgegeben wird, kann der Aufrufer Fehlerinformationen abrufen, indem er die GetLastError Routine aufruft.

Der Datenträger, dessen Handle verwendet wird, wenn dieses IOCTL ausgegeben wird, befindet sich möglicherweise im Offlinezustand, wenn die IOCTL ausgestellt wird. Wenn der Datenträger mithilfe des MMC-Snap-Ins (Disk Manager Microsoft Management Console) in den Offlinezustand versetzt wird, hat der Datenträger den schreibgeschützten Attributsatz, der dazu führt, dass diese IOCTL fehlschlägt. Wenn das Datenträgerpartitionsprogramm (Diskpart.exe) jedoch verwendet wird, um den Datenträger in den Offlinezustand zu versetzen, wird das schreibgeschützte Attribut für den Datenträger nicht festgelegt. Aus diesem Grund empfiehlt es sich, das Datenträgerpartitionshilfsprogramm zu verwenden, um einen Datenträger in den Offlinezustand zu versetzen.

Hinweis Ein Nebeneffekt der Verwendung dieser IOCTL besteht darin, dass Datenträgerverwaltungstools möglicherweise eine zusätzliche Partition des Typs "UNBEKANNT" auf GPT-Datenträgern melden können. Diese 256 Kilobyte-Partition wird vom IOCTL-Vorgang erstellt und ist eine Momentaufnahmepartition, die im Wiederherstellungsvorgang verwendet wird. Diese Partition wird erwartet und kann von Systemadministratoren ignoriert werden.

 

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows Vista.
Header-	ntdddisk.h (include Ntdddisk.h)
IRQL-	PASSIVE_LEVEL