Partager via

NPAddConnection3, fonction (npapi.h)

La fonction NPAddConnection3 connecte un appareil local à une ressource réseau. Il effectue la même opération que NPAddConnection , mais en outre vous permet de spécifier un handle dans la fenêtre qui doit posséder les boîtes de dialogue résultantes et spécifier la façon dont la connexion doit être établie.

Syntaxe

DWORD NPAddConnection3(
  [in] HWND           hwndOwner,
  [in] LPNETRESOURCEW lpNetResource,
  [in] LPWSTR         lpPassword,
  [in] LPWSTR         lpUserName,
  [in] DWORD          dwFlags
);

Paramètres

[in] hwndOwner

Handle vers une fenêtre qui doit posséder des messages ou boîtes de dialogue. Ce handle est valide uniquement si CONNECT_INTERACTIVE est défini dans dwFlags et que le handle ne doit être utilisé que pour produire des boîtes de dialogue nécessaires à l’authentification.

[in] lpNetResource

Pointeur vers une structure NETRESOURCE qui spécifie la ressource réseau à laquelle se connecter. Les champs suivants doivent être définis lors de l’établissement d’une connexion. Les autres sont ignorés.

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 la chaîne vide ou le 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.

[in] dwFlags

Toute combinaison des valeurs suivantes. Le fournisseur doit ignorer tous les autres bits de dwFlags qui peuvent être définis.

Valeur Meaning
CONNECT_TEMPORARY
 La connexion est établie à des fins de navigation et sera probablement publiée rapidement.
CONNECT_INTERACTIVE
 La connexion peut avoir une interaction avec l’utilisateur à des fins d’authentification.
CONNECT_PROMPT
 N’utilisez pas de valeurs par défaut pour les noms d’utilisateur ou les mots de passe sans offrir à l’utilisateur une possibilité de fournir une alternative. Cet indicateur n’est valide que si CONNECT_INTERACTIVE est également défini.
CONNECT_DEFERRED
 N’effectuez aucune opération réseau distante pour établir la connexion réseau ; au lieu de cela, restaurez la connexion dans un « état déconnecté ». Essayez la connexion réelle uniquement quand un processus tente d’utiliser la connexion. Si ce bit est défini, l’appelant doit fournir lpLocalName.

Cette fonctionnalité est utilisée pour accélérer la restauration des connexions réseau au niveau de l’ouverture de session. Un fournisseur qui le prend en charge doit retourner le bit WNNC_CON_DEFERRED dans NPGetCaps.

Valeur retournée

Si la fonction réussit, elle retourne WN_SUCCESS. Sinon, il retourne un code d’erreur. Cela peut inclure 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.
WN_CANCEL
 La tentative d’annulation de la connexion a été annulée par l’utilisateur à l’aide d’une boîte de dialogue affichée par le fournisseur.

Remarques

Si un fournisseur affiche une boîte de dialogue de mot de passe, car les informations d’identification spécifiées sont insuffisantes et que l’indicateur de CONNECT_INTERACTIVE est défini, le fournisseur peut ne pas retourner un code d’erreur refusé par accès (l’un des ERROR_LOGON_FAILURE, WN_BAD_PASSWORD, WN_ACCESS_DENIED). Le comportement suggéré est que le fournisseur continue à demander à l’utilisateur des informations d’identification valides jusqu’à ce que l’utilisateur les fournisse ou appuie sur un bouton « Annuler ». Si NPAddConnection3 est appelé pour établir la connexion demandée pendant la fonction WNetConnectionDialog ou WNetConnectionDialog1 et qu’un code refusé par accès est retourné, la fonction WNetConnectionDialog ou WNetConnectionDialog1 affiche une boîte de dialogue de mot de passe.

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

Voir aussi

NPAddConnection

  • Last updated on