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")