Functions > FileDirDisk >

DriveMapAdd

Connecte un lecteur r�seau.

DriveMapAdd ( "device", "remote share" [, flags = 0 [, "user" [, "password"]]] )

Param�tres

device	P�riph�rique � connecter, par exemple "O:" ou "LPT1:". Si vous passez une cha�ne vide pour ce param�tre une connexion est �tablie mais elle n'est pas mapp�e � un lecteur sp�cifique. Si vous sp�cifiez "*" une lettre de lecteur non utilis�e sera automatiquement s�lectionn�e.
remote share	Le partage distant pour une connexion sous la forme "\\server\share".
flags	[optionnel] Une combinaison des �l�ments suivant: $DMA_DEFAULT (0) = Par d�faut $DMA_PERSISTENT (1) = Connexion persistante $DMA_AUTHENTICATION (8) = Affiche le dialogue d'authentification si n�cessaire Les constantes sont d�finies dans "AutoItConstants.au3"
user	[optionnel] Le nom de l'utilisateur � utiliser pour la connexion. Sous la forme "username" ou "domain\username".
password	[optionnel] Le mot de passe � utiliser pour la connexion.

Valeur de retour

Succ�s:	Retourne 1. (Consultez les remarques)
�chec:	Retourne 0 si une nouvelle connexion ne peut pas �tre cr�� et d�finit @error <> 0.
@error:	1 = Erreur Ind�finie/Autre. @extended est d�fini avec le code de retour de l'API Windows 2 = L'acc�s au partage distant a �t� refus� 3 = Le p�riph�rique est d�j� assign� 4 = Nom de p�riph�rique invalide 5 = Partage distant invalide 6 = Mot de passe invalide

Remarques

Note: En utilisant "*" comme param�tre de p�riph�rique, la lettre de lecteur s�lectionn�e sera retourn�e au lieu de 1 ou 0, par exemple "U:". S'il y avait une erreur en utilisant "*" alors une cha�ne vide "" serait retourn�e.

Si user/password sont d�finis, ils seront pr�sent�s � l'ordinateur distant qui validera le certificat.

En relation

DriveMapDel, DriveMapGet

Exemple

#include <AutoItConstants.au3>

; Mappe le lecteur X sur \\monserveur\stuff en utilisant l'utilisateur courant
DriveMapAdd("X:", "\\myserver\stuff")

; Mappe le lecteur X sur \\myserver2\stuff2 en utilisant l'utilisateur "jon" du "domainx" avec le mot de passe "tickle"
DriveMapAdd("X:", "\\myserver2\stuff2", $DMA_DEFAULT, "domainx\jon", "tickle")