Method DriveMapAdd

AutoIt X

Method Reference


DriveMapAdd

Maps a network drive

DriveMapAdd "device", "remote share" [, flags [, "user" [, "password"]]]

Parameters

device The device to map, for example "O:" or "LPT1:". If you pass a blank string for this parameter a connection is made but not mapped to a specific drive. If you specify "*" an unused drive letter will be automatically selected.
remote share The remote share to connect to in the form "\\server\share".
flags Optional:
A combination of the following:
0 = default
1 = Persistant mapping
8 = Show authentication dialog if required
user Optional: The username to use to connect. In the form "username" or "domain\username".
password Optional: The password to use to connect.

Return Value

Success: Returns 1. (See Remarks)
Failure: Returns 0 if a new mapping could not be created and sets oAutoIt.error (see below). (See Remarks)

Remarks

When the function fails (returns 0) oAutoIt.error contains extended information:
    1 = Undefined / Other error
    2 = Access to the remote share was denied
    3 = The device is already assigned
    4 = Invalid device name
    5 = Invalid remote share
    6 = Invalid password

Note: When using "*" for the device parameter the drive letter selected will be returned instead of 1 or 0, e.g. "U:". If there was an error using "*" then a blank string "" will be returned.

Related

DriveMapDel, DriveMapGet

Example


Set oAutoIt = WScript.CreateObject("AutoItX3.Control")

' Map X drive to \\myserver\stuff using current user
oAutoIt.DriveMapAdd "X:", "\\myserver\stuff"

' Map X drive to \\myserver2\stuff2 using the user "jon" from "domainx" with password "tickle"
oAutoIt.Drivemap "X:", "\\myserver2\stuff2", 0, "domainx\jon", "tickle"