IOCTL_VOLUME_ONLINE IOCTL (ntddvol.h)
Die IOCTL_VOLUME_ONLINE IOCTL versetzt das Volume in einen ONLINE-Zustand, d. h. einen Zustand, in dem Lese- und Schreibvorgänge ausgeführt werden. Die Anforderungen werden an den physischen Datenträger übergeben, bis eine nachfolgende IOCTL_VOLUME_OFFLINE empfangen wird.
Eine häufige Verwendung für IOCTL_VOLUME_ONLINE ist ein Fall, in dem der Bereitstellungs-Manager ein neues Volume automatisch in den ONLINE-Zustand versetzt, wenn das Volume eintrifft, es sei denn, dieses Volume ist in einem Registrierungsschlüssel aufgeführt, der vom Clusterdienst aufgefüllt wird. IOCTL_VOLUME_ONLINE wird für Wechseldatenträger unabhängig von der Einstellung NoAutoMount im folgenden Registrierungsschlüssel aufgerufen:
HKCU\System\CurrentControlSet\Services\Mountmgr\NoAutoMount
Bei Volumes, die von NoAutoMount gesteuert werden, führt die Zuweisung eines Laufwerkbuchstabens jedoch dazu, dass IOCTL_VOLUME_ONLINE aufgerufen wird.
Für Volumes, die vom Clusterdienst gesteuert werden, wird IOCTL_VOLUME_ONLINE vom Clusterdienst gesendet, wenn der lokale Knoten besitzer des Volumes ist. Der Clusterdienst verwendet sowohl IOCTL_VOLUME_ONLINE als auch IOCTL_VOLUME_ONLINE , um E/A auf einem Datenträgervolume zuzulassen, wenn sich das Datenträgervolume im Besitz des lokalen Servers befindet. Bis der Clusterdienst das Datenträgervolume in einen ONLINE-Zustand versetzt, ist keine E/A für das Datenträgervolume zulässig. Dadurch wird eine Beschädigung des Datenträgervolumes verhindert, die dadurch entstehen kann, dass mehrere Clusterknoten gleichzeitig auf dasselbe Datenträgervolume schreiben.
Hauptcode
Eingabepuffer
Keine.
Länge des Eingabepuffers
Keine.
Ausgabepuffer
Keine.
Länge des Ausgabepuffers
Keine.
Statusblock
Das Status-Element ist auf STATUS_SUCCESS festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows XP. |
| Kopfzeile | ntddvol.h (include Ntddvol.h) |