Описание функции


DriveMapAdd

Подключает сетевой диск.

DriveMapAdd('device','remote_share'[,flags=0[,'user'[,'password']]])

Параметры

device Если вы передадите пустую строку в качестве этого параметра, подключение будет производиться, но без отображения на заданное устройство. Если в качестве параметра будет использовано '*', то будет автоматически выбрано неиспользуемое устройство.
remote_share Удаленный ресурс для подключения в форме '\\server\share'.
flags [необязательный] Может быть комбинацией следующих значений:
0 = (по умолчанию)
1 = постоянное подключение
8 = показать диалог ввода пароля, если требуется
user [необязательный] Имя пользователя для подключения. В форме 'username' или 'domain\username'.
password [необязательный] Пароль для использования при подключении.

Возвращаемое значение

Успех:Возвращает 1 (см. примечания).
Ошибка:Возвращает 0, если новое подключение не может быть создано и устанавливает значение @error (см. ниже).

Примечания

Если функция не может подключить сетевой диск (Возвращаемое значение равно 0), то @error содержит дополнительную информацию:
1 = не определено / другие ошибки. Значение @extended равно значению, возвращённому Windows API
2 = доступ к удаленному ресурсу закрыт
3 = устройство уже подключено
4 = неправильное имя устройства
5 = неправильный удаленный ресурс
6 = неправильный пароль

Примечание: при использовании '*' в качестве имени подключаемого устройства функция будет возвращать не 1 или 0, а строку с именем подключенного устройства, например 'U:'. Если произойдет ошибка при использовании '*', то функция вернёт пустую строку "".

Если заданы user/password, то они предоставляются удаленному компьютеру, который проверит их допустимость.

Функцию можно подключить через команду exect

См. также

DriveMapDel, DriveMapGet

Примеры:
 Как создать кнопку?


exect=DriveMapAdd('X:','\\myserver\stuff') ;; присоединить X диск в \\myserver\stuff для использования текущим пользователем

exect=DriveMapAdd('X:','\\myserver2\stuff2',0,'domainx\jon','tickle') ;; присоединить X диск в \\myserver2\stuff2 для использования пользователем "jon" из домена "domainx" с паролем "tickle"

exect=DriveMapAdd('X:','\\myserver\stuff')||$var_sinfo=DriveMapGet('X:')||_ViewValues('$var_sinfo') ;; присоединяет X диск и получает информацию о подключении


© Аверин Андрей для Total Commander Image  Averin-And@yandex.ru