|
<< Click to Display Table of Contents >> Navigation: 3. Script Language > Internet and Network > Internet and Network Commands |
MiniRobotLanguage (MRL)
RDM. Command
Remove Mapped Network Drive
Intention
Can be used to remove a mapped network drive, temporary or permanently.
Just use the command and specify which Mapping to remove:
' Remove Mapping for Drive F: temporary
RDM.F
' Remove Mapping for Drive F: permanent
RDM.F|1
' Remove Mapping for Drive F: permanent
' and verify it was removed
RDM.F|1|$$ERG
IVV.$$ERG=0
MBX.Success
EIF.
Hint: Use the MND. - Map Network Drive to add a Mapped Drive.
Syntax
RDM.P1[|P2][|P2]
Parameter Explanation
P1 - Driveletter, for example Y or M
P2 - (optional). 1/0 -If 1 is specified, teh Mapping is permanently removed.
If 0 or nothing is specified, the drive mapping is removed, but possibly
restored at next reboot.
P3 - (optional). Variable that will return the result of the operation. In case of
success the result will be zero. In case of error an error number is returned.
1206 - ERROR_BAD_PROFILE
The user profile is in an incorrect format.
1205 - ERROR_CANNOT_OPEN_PROFILE
The system is unable to open the user profile to process persistent connections.
2404 - ERROR_DEVICE_IN_USE
The device is in use by an active process and cannot be disconnected.
1208 - ERROR_EXTENDED_ERROR
A network-specific error occurred.
2250 - ERROR_NOT_CONNECTED
The name specified is not a redirected device, or the system is not currently connected to the device specified by the parameter.
2401 - ERROR_OPEN_FILES
There are open files. This error should not occur, as the Command uses force to break the connection.
Example
'-----------------------------------------------------------
' RDM. - Get Computer Name
'
RDM.F
RDM.F|0|$$RES
ENR.
Remarks
If the command fails, the Timeout-Flag is set, otherwise it will be cleared.
Limitations:
-
See also: