WNetAddConnectionA |
mpr.dll | Ajoute une connexion réseau |
|---|---|---|
Syntaxe
| DWORD WNetAddConnectionA(LPTSTR lpszRemoteName, LPTSTR lpszPassword,LPTSTR lpszLocalName ); |
Paramètres
| Nom | Description |
|---|---|
| lpRemoteName | Ce paramètre permet d'indiquer un pointeur sur une chaîne de caractères à terminaison NULL constante spécifiant la ressource réseau à laquelle se connecter. |
| lpPassword | Ce paramètre permet d'indiquer un pointeur sur une chaîne de caractères à terminaison NULL constante spécifiant le mot de passe à utiliser pour établir une connexion. Ce paramètre est généralement le mot de passe associé à l'utilisateur actuel. Si ce paramètre est NULL, le mot de passe par défaut est utilisé. Si la chaîne de caractères est vide, aucun mot de passe n'est utilisé. Sous Windows 9X (Windows 95, Windows 98 et Windows Me), ce paramètre doit être NULL ou une chaîne de caractères vide. |
| lpLocalName | Ce paramètre permet d'indiquer un pointeur sur une chaîne de caractères constante terminée par le caractère NULL spécifiant le nom d'un périphérique local à rediriger, tel que «F:» ou «LPT1». La chaîne de caractères est traitée sans distinction de casse. Si la chaîne de caractères est NULL, alors une connexion à la ressource réseau est établie sans rediriger le périphérique local. |
Retour
| Valeur | Description |
|---|---|
| NO_ERROR | Cette valeur permet d'indiquer que la fonction a été un succès. |
| ERROR_ACCESS_DENIED | Cette valeur permet d'indiquer que l'appelant n'a pas accès à la ressource réseau. |
| ERROR_ALREADY_ASSIGNED | Cette valeur permet d'indiquer que le périphérique spécifié dans le paramètre lpLocalName est déjà connecté. |
| ERROR_BAD_DEV_TYPE | Cette valeur permet d'indiquer que le type de périphérique et le type de ressource ne correspondent pas. |
| ERROR_BAD_DEVICE | Cette valeur permet d'indiquer que la valeur spécifiée dans le paramètre lpLocalName n'est pas valide. |
| ERROR_BAD_NET_NAME | Cette valeur permet d'indiquer que la valeur spécifiée dans le paramètre lpRemoteName n'est pas valide ou est introuvable. |
| ERROR_BAD_PROFILE | Cette valeur permet d'indiquer que le profil de l'utilisateur est dans un format incorrect. |
| ERROR_CANNOT_OPEN_PROFILE | Cette valeur permet d'indiquer que le système ne peut pas ouvrir le profil utilisateur pour traiter les connexions persistantes. |
| ERROR_DEVICE_ALREADY_REMEMBERED | Cette valeur permet d'indiquer qu'une entrée pour le périphérique spécifié dans le paramètre lpLocalName se trouve déjà dans le profil utilisateur. |
| ERROR_EXTENDED_ERROR | Cette valeur permet d'indiquer qu'une erreur spécifique au réseau s'est produite. Pour obtenir une description de l'erreur, appelez la fonction WNetGetLastErrorA. |
| ERROR_INVALID_PASSWORD | Cette valeur permet d'indiquer que le mot de passe spécifié n'est pas valide. |
| ERROR_NO_NET_OR_BAD_PATH | Cette valeur permet d'indiquer que l'opération ne peut pas être effectuée car une composante réseau n'est pas démarré ou parce qu'un nom spécifié ne peut pas être utilisé. |
| ERROR_NO_NETWORK | Cette valeur permet d'indiquer que le réseau est indisponible. |
Description
Cette fonction permet d'effectuer la connexion d'une unité de disque à une ressource réseau.
Remarques
- Sous les systèmes d'exploitation Windows Server 2003 et Windows XP, les fonctions WNet créent et suppriment des lettres d'unité de disque réseau dans l'espace de noms de périphérique DOS associé à une session, car les périphériques DOS sont identifiés par AuthenticationID (un identifiant unique local ou LUID associé à une session de connexion.) Cette situation peut affecter les applications appelant l'une des fonctions WNet pour créer une lettre d'unité de disque réseau sous une connexion utilisateur, mais interrogent les lettres de l'unité de disque réseau existantes sous une autre connexion utilisateur. Un exemple de cette situation pourrait être lorsque la deuxième connexion d'un utilisateur est créée dans une session d'ouverture de session, par exemple, en appelant la fonction CreateProcessAsUserA et que la seconde ouverture de session exécute une application appelant la fonction GetLogicalDrives. L'appel à la fonction GetLogicalDrives ne renvoie pas les lettres de l'unité de disque réseau créées par les appels de fonction WNet lors de la première connexion. Notez que dans l'exemple précédent, la première session d'ouverture de session existe toujours et que l'exemple pourrait s'appliquer à toute session d'ouverture de session, y compris une session des services Terminal Server.
- Sous les systèmes d'exploitation Windows Server 2003 et Windows XP, si un service s'exécutant en tant que LocalSystem appelle la fonction WNetAddConnectionA, l'unité de disque cartographié est visible pour toutes les sessions d'ouverture de session utilisateur.
Voir également
Langage de programmation - C pour Windows - API de Windows - WNetAddConnection2A
Langage de programmation - C pour Windows - API de Windows - WNetAddConnection3A
Langage de programmation - C pour Windows - API de Windows - WNetCancelConnectionA
Langage de programmation - C pour Windows - API de Windows - WNetCancelConnection2A
Langage de programmation - C pour Windows - API de Windows - WNetGetConnectionA
Dernière mise à jour : Dimanche, le 6 décembre 2015