This IOCTL directs the mount manager to keep a symbolic link active after the Plug and Play manager has given notification that its corresponding volume has gone offline. When the volume goes back online, the mount manager reassigns the symbolic link to the volume. No other volume is allowed to claim the symbolic link while its original owner is offline.
Clusters use this IOCTL to ensure that a node can continue to access a volume with the same drive letter, even if the volume is not continually present in the system.
The mount manager client loads the following structure with the symbolic link that will persist even after its volume is removed from the system. The initialized structure MOUNTMGR_TARGET_NAME, defined in Mountmgr.h, is inserted at the beginning of the buffer at Irp->AssociatedIrp.SystemBuffer.
Input Buffer Length
Parameters.DeviceIoControl.InputBufferLength in the I/O stack location of the IRP indicates the size, in bytes, of the input buffer, which must be greater than or equal to sizeof(MOUNTMGR_TARGET_NAME).
Output Buffer Length
If the operation is successful, the Status field is set to STATUS_SUCCESS.
The input buffer size, indicated by InputBufferLength, must be large enough to hold the structure MOUNTMGR_TARGET_NAME and the symbolic link name that follows it. If it is not large enough, the Status field is set to STATUS_INVALID_PARAMETER.
|Header||mountmgr.h (include Mountmgr.h)|