WNetAddConnection2

 Retour fonctions Api

Retour fonctions de réseau

Description

Paramètre

lpNetResource

lpPassword

lpUserName

dwFlags

Valeur renvoyée

Démarre une connection à une ressource réseau

Type/Description

NETRESOURCE - Structure NETRESOURCE qui spécifie le détail de la connection proposée : information à propos de la ressource réseau, le device local, et le fournisseur de la ressource réseau.
Vous devez spécifier les membres suivants de la structure NETRESOURCE :

dwType : spécifie le type de ressource réseau vers lequel se connecter

lpLocalName : chaîne (null terminated) spécifiant le nom d'un device local a être redirigé vers, comme par exemple "F:" ou "LPT1"

lpRemoteName : chaîne (null terminated) spécifiant la ressource réseau vers laquelle se connecter

lpProvider : chaîne (null terminated) spécifiant le fournisseur réseau vers lequel se connecter. Si lpProvider est NULL ou une chaîne vide, le système essaye de déterminer le fournisseur exact en analysant la chaîne lpRemoteName

Remarque : La fonction WNetAddConnection2 ignore les autres membres de la structure NETRESOURCE

String - chaîne (null terminated) spécifiant un mot de passe utilisé pour faire une connection réseau
Si lpPassword est NULL, la fonction utilise le mot de passe par défaut associé à l'utilisateur spécifié dans lpUserName

String - chaîne (null terminated) spécifiant le nom d'utilisateur a utiliser pour faire la connection
Si lpUserName est NULL, la fonction utilise le nom d'utilisateur par défaut

Long - flags spécifiant les options de connection. Le flag suivant est couramment défini :

CONNECT_UPDATE_PROFILE : la connection à la ressource réseau doit être enregistrée. Le système restaurera automatiquement la connection lorsque l'utilisateur se connectera.

Long - Si la fonction réussi, la valeur de retour est NO_ERROR.
Si elle échoue, la valeur sera un code d'erreur. Pour obtenir des informations étendues sur l'erreur, faîtes appel à GetLastError.
Lorsque le fonction échoue, un des codes suivants sera retourné :

ERROR_ACCESS_DENIED : l'accès à la ressource réseau a été refusé

ERROR_ALREADY_ASSIGNIED : le device local spécifié par lpLocalName est déjà connecté à une ressource réseau

ERROR_BAD_DEV_TYPE : le type de device local et le type de réseau ne corresponde pas

ERROR_BAD_DEVICE : la valeur spécifiée par lpLocalName n'est pas valide

ERROR_BAD_NET_NAME : la valeur spécifiée par lpRemoteName n'est pas acceptée par aucun fournisseur d'une ressource réseau

ERROR_BAD_PROFILE : le profil de l'utilisateur est dans un format incorrect

ERROR_BAD_PROVIDER : la valeur spécifiée par lpProvider ne correspond à aucun fournisseur

ERROR_BUSY : le routeur ou fournisseur sont occupés, ou en initialisation. L'appelant devra ré-essayé.

ERROR_CANCELLED : l'essai pour faire une connection a été annulé par l'utilisateur

ERROR_CANNOT_OPEN_PROFILE : le système est incapable d'ouvrir le profil de l'utilisateur

ERROR_DEVICE_ALREADY_REMEMBERED : une entrée pour le device (périphérique) spécifié dans lpLocalName est déjà dans le profil de l'utilisateur

ERROR_EXTENDED_ERROR : une erreur réseau spécifique a eu lieu. Faites appel à WNetGetLastError pour obtenir une description de l'erreur.

ERROR_INVALID_PASSWORD : le mot de passe spécifié n'est pas valide

ERROR_NO_NET_OR_BAD_PATH : le composant réseau n'a pas démarré, ou le nom spécifié n'a pas pu être traité

ERROR_NO_NETWORK : le réseau n'est pas disponible