IOCTL_MOUNTMGR_KEEP_LINKS_WHEN_OFFLINE IOCTL

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.

Major Code

IRP_MJ_DEVICE_CONTROL

Input Buffer

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

None

Output Buffer Length

None

Status Block

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.

Requirements

   
Header mountmgr.h (include Mountmgr.h)

See Also

MOUNTMGR_TARGET_NAME