IOCTL_VOLUME_OFFLINE IOCTL (ntddvol.h)
Die IOCTL_VOLUME_OFFLINE IOCTL versetzt das Volume in einen OFFLINE-Zustand. Dabei handelt es sich um einen Zustand, in dem Lese- und Schreibvorgänge fehlschlagen. Die Anforderungen werden erst an den physischen Datenträger übergeben, wenn eine nachfolgende IOCTL_VOLUME_ONLINE empfangen wird.
Eine häufige Verwendung für IOCTL_VOLUME_OFFLINE ist ein Fall, in dem eine Anwendung oder ein Treiber verhindern möchte, dass ein Volume von einem Aufruf erneut bereitgestellt wird, um das Volume von einer zweiten Anwendung oder einem zweiten Treiber zu öffnen, während das Volume von der ersten Anwendung oder dem ersten Treiber entfernt wird. Vor dem Maskieren einer logischen Einheitennummer (Logical Unit Number, LUN) sollten die Volumes auf dem LUN beispielsweise gesperrt (optional), die Bereitstellung aufgehoben, offline geschaltet und deinstalliert werden. Jetzt kann die LUN maskiert werden, ohne dass Plug and Play (PnP) Überraschungsentfernungsereignisse für die Volumes und den Datenträger selbst protokolliert werden. Ohne den Aufruf, um das Volume offline zu schalten, kann das Volume nach dem Schließen des Handles, das zum Aufheben der Bereitstellung verwendet wird, von einem Aufruf erneut bereitgestellt werden, um es von einer anderen Anwendung oder einem anderen Treiber zu öffnen, falls es vor dem Aufruf zum Deinstallieren des Volumes aufgetreten ist. Ein Aufruf zum Öffnen eines Volumes ist auf einem Offlinevolume erfolgreich, aber E/A, die auf ein Offlinevolume gerichtet ist, schlägt fehl. Das Offlineschalten eines Volumes hat keine Auswirkungen auf die Datenträger-E/A (wenn die Anwendung oder der Treiber ein Handle auf dem Datenträger geöffnet hat), aber die Volume-E/A beendet (wenn die Anwendung oder der Treiber ein Handle für das Volume geöffnet hat).
Hauptcode
Eingabepuffer
Nichts.
Eingabepufferlänge
Nichts.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
Der Status- Member ist auf STATUS_SUCCESS festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows XP. |
| Header- | ntddvol.h (include Ntddvol.h) |