Aide:DriveMapAdd.txt

Document original V3.3.6.1 :

###Function###
DriveMapAdd

###Description###
Maps a network drive.

###Syntax###
DriveMapAdd ( "device", "remote share" [, flags [, "user" [, "password"]]] )


###Parameters###
@@ParamTable@@
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 = Persistent 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.
@@End@@

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


###Remarks###
When the function fails (returns 0) @error contains extended information:
 1 = Undefined / Other error. @extended set with Windows API return
 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.

If defined the user/password will be presented to the remote computer that will validate the credential.


###Related###
DriveMapDel, DriveMapGet


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
DriveMapAdd

###Description###
Mappe un lecteur réseau.


###Syntax###
DriveMapAdd ( "device", "remote share" [, flags [, "user" [, "password"]]] )


###Parameters###
@@ParamTable@@
device
	Périphérique à mapper, par exemple "O:" ou "LPT1:". Si vous passez une chaîne vide pour ce paramètre une connexion est établie mais 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 à connecter sous la forme "\\server\share".
flags
	[optionnel] Une combinaison des éléments suivant :
		0 = Défaut
		1 = Connexion persistante
		8 = Montre la demande d'authentification si nécessaire
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.
@@End@@

###ReturnValue###
@@ReturnTable@@
Succès:	Retourne 1. (Voir les remarques)
Échec:	Retourne 0 si une nouvelle connexion ne peut pas être créée et assigne @error. (Voir les remarques).
@@End@@

###Remarks###
Lorsque la fonction échoue (retourne 0) @error contient des informations détaillées
	1 = Non définie / Autre erreur. @extended est définit par 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 non valide

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.


###Related###
<a href="DriveMapDel.htm">DriveMapDel</a>, <a href="DriveMapGet.htm">DriveMapGet</a>


###Example###
@@IncludeExample@@

Traducteur : Strofe

Contributeurs (pour les modifications avant le Wiki) : Tlem