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]]]] )
| $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). |
| 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. |
Consultez WNetUseConnection dans la librairie MSDN.