UDF > WinNet >


_WinNet_UseConnection

Connecte un p�riph�rique local � une ressource r�seau

#include <WinNet.au3>
_WinNet_UseConnection ( $hWnd, $sLocalName, $sRemoteName [, $sUserName = 0 [, $sPassword = 0 [, $iType = 1 [, $iOptions = 1]]]] )

Param�tres

$hWnd Handle de la fen�tre que le fournisseur des ressources r�seau peut utiliser comme une fen�tre propri�taire pour les dialogues.
Utilisez ce param�tre si vous d�finissez le bit 2 (interactif) dans le param�tre $iOptions.
Ce param�tre peut �tre 0.
$sLocalName Nom d'un p�riph�rique local � rediriger, comme "F:" ou "LPT1".
La cha�ne est trait�e de mani�re insensible � la casse.
Si cette valeur est 0, une connexion � la ressource r�seau est �tablie sans rediriger le p�riph�rique local.
$sRemoteName Nom de la ressource r�seau � laquelle se connecter
$sUsername [optionnel] Nom d'utilisateur pour �tablir la connexion.
Si cette valeur est 0, la fonction utilise le nom d'utilisateur par d�faut.
$sPassword [optionnel] Mot de passe � utiliser pour �tablir la connexion.
Si cette valeur est 0, le mot de passe par d�faut est utilis�. Si la cha�ne est vide, aucun mot de passe n'est utilis�.
$iType [optionnel] Sp�cifie le type de ressource r�seau � laquelle se connecter:
    0 - Toutes les ressources (seulement si $sLocalName est vide)
    1 - Disque
    2 - Imprimante
$iOptions [optionnel] Options de connexion. Peut �tre l'une ou plusieurs des valeurs suivantes:
    1 - La connexion de la ressource r�seau doit �tre m�moris�e
    2 - Le syst�me d'exploitation peut interagir avec l'utilisateur � des fins d'authentification
    4 - Le syst�me n'utilise pas de param�tre par d�faut pour les noms d'utilisateur ou les mots de passe sans offrir � l'utilisateur la possibilit� de fournir une alternative.
Ce flag est ignor� si le bit 2 (interactif) est �galement d�finie.
    8 - Force la redirection d'un p�riph�rique local au moment de la connexion
    16 - Le syst�me d'exploitation invite l'utilisateur � s'authentifier � l'aide de la ligne de commande au lieu d'une GUI.
Ce flag est ignor� si le bit 2 (interactif) est �galement d�finie.
    32 - Si ce bit est d�fini, et le syst�me d'exploitation demande l'identification, l'identification est sauv�e par le gestionnaire d'identification.
Si le gestionnaire d'identification est d�sactiv� pour la session d'ouverture de l'appelant, ou si le fournisseur de r�seau ne prend pas en charge l'enregistrement des identifications, ce flag est ignor�.
Ce drapeau est �galement ignor�e sauf si vous d�finissez le bit 5 (ligne de commande au lieu de GUI).

Valeur de retour

Succ�s: Retourne un tableau avec le format suivant:
    $aInfo[0] - Si True, la connexion a �t� �tablie en utilisant la redirection d'un p�riph�rique local
    $aInfo[1] - Si $sLocalName sp�cifie un p�riph�rique local, c'est le nom de p�riph�rique local.
Si $sLocalName ne sp�cifie pas un p�riph��rique et si le r�seau n�cessite une redirection de p�riph�rique local, ou si le bit 4 (force la redirection) est lev�, ce tampon re�oit le nom du p�riph�rique local redirig�.
Dans le cas contraire, le nom copi� dans la m�moire tampon est celui d'une ressource distante.
�chec: D�finit @error <> 0.

Voir aussi

Consultez WNetUseConnection dans la librairie MSDN.