IOCTL_MOUNTMGR_KEEP_LINKS_WHEN_OFFLINE IOCTL (mountmgr.h)
Diese IOCTL weist den Einbindungs-Manager an, einen symbolischen Link aktiv zu halten, nachdem der Plug and Play-Manager die Benachrichtigung erhalten hat, dass das entsprechende Volume offline geschaltet wurde. Wenn das Volume wieder online geschaltet wird, wird die symbolische Verknüpfung dem Volume vom Bereitstellungs-Manager neu zugewiesen. Kein anderes Volume darf den symbolischen Link beanspruchen, während der ursprüngliche Besitzer offline ist.
Cluster verwenden diese IOCTL, um sicherzustellen, dass ein Knoten weiterhin auf ein Volume mit demselben Laufwerkbuchstaben zugreifen kann, auch wenn das Volume nicht ständig im System vorhanden ist.
Hauptcode
Eingabepuffer
Der Bereitstellungs-Manager-Client lädt die folgende Struktur mit dem symbolischen Link, der auch nach dem Entfernen des Volumes aus dem System beibehalten wird. Die initialisierte Struktur MOUNTMGR_TARGET_NAME wird am Anfang des Puffers bei Irp-AssociatedIrp.SystemBuffer> eingefügt.
Länge des Eingabepuffers
Parameters.DeviceIoControl.InputBufferLength in der E/A-Stapelposition des IRP gibt die Größe des Eingabepuffers in Bytes an, die größer oder gleich sizeof(MOUNTMGR_TARGET_NAME)sein muss.
Ausgabepuffer
Keine.
Länge des Ausgabepuffers
Keine.
Eingabe-/Ausgabepuffer
–
Länge des Eingabe-/Ausgabepuffers
–
Statusblock
Wenn der Vorgang erfolgreich ist, wird das Feld Status auf STATUS_SUCCESS festgelegt.
Die durch InputBufferLength angegebene Eingabepuffergröße muss groß genug sein, um die Struktur MOUNTMGR_TARGET_NAME und den darauf folgenden symbolischen Linknamen zu enthalten. Wenn es nicht groß genug ist, wird das Feld Status auf STATUS_INVALID_PARAMETER festgelegt.
Hinweise
Weitere Informationen finden Sie unter Unterstützen von Einbindungs-Manager-Anforderungen in einem Speicherklassentreiber.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | mountmgr.h (Mountmgr.h einschließen) |