Partager via

NPAddConnection, fonction (npapi.h)

La fonction NPAddConnection connecte un appareil local à une ressource réseau.

Syntaxe

DWORD NPAddConnection(
  [in] LPNETRESOURCEW lpNetResource,
  [in] LPWSTR         lpPassword,
  [in] LPWSTR         lpUserName
);

Paramètres

[in] lpNetResource

Pointeur vers une structure NETRESOURCE qui spécifie la ressource réseau à laquelle se connecter. Les champs suivants doivent être définis dans la structure NETRESOURCE que vous transmettez. La fonction NPAddConnection ignore les autres champs.

Valeur Meaning
lpRemoteName
 Spécifie la ressource réseau à laquelle se connecter.
lpLocalName
 Spécifie le nom d’un appareil local à rediriger, par exemple « F : » ou « LPT1 ». Ce nom est traité comme non sensible à la casse et peut être une chaîne vide ou un pointeur NULL . Si la chaîne est vide ou NULL, la fonction se connecte à la ressource réseau sans effectuer de redirection.
dwType
 Spécifie le type de ressource auquel se connecter. Cela peut être RESOURCETYPE_DISK, RESOURCETYPE _PRINT ou RESOURCETYPE_ANY. La valeur RESOURCETYPE _ANY est utilisée si l’appelant ne s’occupe pas ou ne sait pas.

[in] lpPassword

Pointeur vers le mot de passe à utiliser pour établir la connexion, normalement le mot de passe associé à lpUserName. La valeur NULL peut être transmise pour que la fonction utilise le mot de passe par défaut. Une chaîne vide peut être utilisée pour indiquer aucun mot de passe. Lorsque vous avez terminé d’utiliser le mot de passe, effacez-le de la mémoire en appelant la fonction SecureZeroMemory . Pour plus d’informations sur la protection du mot de passe, consultez Gestion des mots de passe.

[in] lpUserName

Pointeur vers le nom d’utilisateur utilisé pour établir la connexion. Si la valeur est NULL, le nom d’utilisateur par défaut (celui de l’utilisateur actuellement connecté) est appliqué. Cela est utilisé lorsque l’utilisateur souhaite se connecter à une ressource, mais a un autre nom d’utilisateur ou compte attribué pour cette ressource.

Par exemple, si vous avez été journalisé à l’aide du nom d’utilisateur « MyAccount » et que vous vouliez vous connecter à une ressource réseau disponible uniquement pour un deuxième compte, où le nom d’utilisateur était « MyOtherAccount », vous pouvez spécifier « MyOtherAccount » dans lpUserName pour vous connecter à la ressource. Vous devez également spécifier le mot de passe de ce deuxième compte dans lpPassword.

Valeur retournée

Si la fonction réussit, elle doit retourner WN_SUCCESS. Sinon, il doit retourner un code d’erreur, qui peut être l’un des éléments suivants.

Code de retour Descriptif
WN_BAD_NETNAME
 La valeur du membre lpRemoteName de la structure passée dans lpNetResource n’est pas valide pour ce fournisseur.
WN_BAD_LOCALNAME
 La valeur du membre lpLocalName de la structure passée dans lpNetResource n’est pas valide.
WN_BAD_PASSWORD
 Le mot de passe spécifié n’est pas valide.
WN_ALREADY_CONNECTED
 L’appareil spécifié dans le membre lpLocalName de la structure passée dans lpNetResource est déjà connecté.
WN_ACCESS_DENIED
 L’autorisation d’établir la connexion est refusée.
WN_NO_NETWORK
 Le réseau n’est pas présent.

Spécifications

Requirement Valeur
Client minimum requis Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Fenêtres
Header npapi.h
Library davclnt.lib
  • Last updated on