IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

Löscht alle hardwarebasierten Momentaufnahme Informationen des Volumeschattenkopie-Diensts (VSS) vom Datenträger. Ein 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

Keine.

Länge des Eingabepuffers

Keine.

Ausgabepuffer

Keine.

Länge des Ausgabepuffers

Keine.

Statusblock

Der Information-Member ist auf 0 (null) festgelegt. Das Statuselement ist auf STATUS_SUCCESS festgelegt, wenn der Vorgang erfolgreich war. Andernfalls wird das Status-Element auf den entsprechenden Fehlercode festgelegt.

Hinweise

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 E/A-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-Steuerungscode von einer Anwendung im Benutzermodus 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 diese IOCTL ausgestellt 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 sein schreibgeschütztes Attribut festgelegt, was dazu führt, dass diese IOCTL fehlschlägt. Wenn jedoch das Festplattenpartitionshilfsprogramm (Diskpart.exe) 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 Festplattenpartitions-Hilfsprogramm zu verwenden, um einen Datenträger in den Offlinezustand zu versetzen.

Hinweis Ein Nebeneffekt der Verwendung dieser IOCTL ist, dass Datenträgerverwaltungstools möglicherweise eine zusätzliche Partition des Typs "UNKNOWN" auf GPT-Datenträgern melden. Diese 256-Kb-Partition wird vom IOCTL-Vorgang erstellt und ist eine Momentaufnahme Partition, die beim Wiederherstellungsvorgang verwendet wird. Diese Partition wird erwartet und kann von Systemadministratoren ignoriert werden.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista.
Kopfzeile	ntdddisk.h (include Ntdddisk.h)
IRQL	PASSIVE_LEVEL