NpAddConnection, fonction (npapi.h)

  • Article

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 Signification
lpRemoteName
 Spécifie la ressource réseau à laquelle se connecter.
lpLocalName
 Spécifie le nom d’un appareil local à rediriger, tel que « F : » ou « LPT1 ». Ce nom est traité comme ne respectant pas 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 à laquelle se connecter. Cela peut être RESOURCETYPE_DISK, RESOURCETYPE _PRINT ou RESOURCETYPE_ANY. La valeur RESOURCETYPE _ANY est utilisée si l’appelant ne se soucie 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é. Elle est utilisée lorsque l’utilisateur souhaite se connecter à une ressource, mais qu’il a un nom d’utilisateur ou un compte attribué différent pour cette ressource.

Par exemple, si vous avez été journalisé à l’aide du nom d’utilisateur « MyAccount » et que vous souhaitez 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 afin de 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 suivants.

Code de retour Description
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 à 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 à 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête npapi.h