NetUseAdd, fonction (lmuse.h)

Article
08/24/2023

La fonction NetUseAdd établit une connexion entre l’ordinateur local et un serveur distant. Vous pouvez spécifier une lettre de lecteur local ou un périphérique d’imprimante à connecter. Si vous ne spécifiez pas de lettre de lecteur local ou de périphérique d’imprimante, la fonction authentifie le client auprès du serveur pour les connexions ultérieures.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetUseAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   LevelFlags,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Paramètres

[in] servername

Nom UNC de l’ordinateur sur lequel exécuter cette fonction. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé. Si le paramètre UncServerName spécifié est un ordinateur distant, l’ordinateur distant doit prendre en charge les appels RPC distants à l’aide du mécanisme hérité du protocole d’accès à distance.

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.

[in] LevelFlags

Valeur qui spécifie le niveau d’informations des données. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
1	Spécifie des informations sur la connexion entre un appareil local et une ressource partagée. Les informations incluent le status de connexion et le type. Le paramètre Buf est un pointeur vers une structure USE_INFO_1 .
2	Spécifie des informations sur la connexion entre un appareil local et une ressource partagée. Les informations incluent le status et le type de connexion, ainsi qu’un nom d’utilisateur et un nom de domaine. Le paramètre Buf est un pointeur vers une structure USE_INFO_2 .

[in] buf

Pointeur vers la mémoire tampon qui spécifie les données. Le format de ces données dépend de la valeur du paramètre Level . Pour plus d’informations, consultez Mémoires tampons de fonction de gestion réseau.

[out] parm_err

Pointeur vers une valeur qui reçoit l’index du premier membre de la structure d’informations en erreur lorsque l’erreur ERROR_INVALID_PARAMETER est retournée. Si ce paramètre a la valeur NULL, l’index n’est pas retourné en cas d’erreur. Pour plus d'informations, consultez la section Notes qui suit.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour est un code d’erreur système. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur système.

Remarques

Vous pouvez également utiliser les fonctions WNetAddConnection2 et WNetAddConnection3 pour rediriger un appareil local vers une ressource réseau.

Aucune appartenance à un groupe spécial n’est requise pour appeler la fonction NetUseAdd . Cette fonction ne peut pas être exécutée sur un serveur distant, sauf en cas de compatibilité de niveau inférieur.

Cette fonction s’applique uniquement au client Server Message Block (station de travail LAN Manager). La fonction NetUseAdd ne prend pas en charge les partages de système de fichiers distribués (DFS). Pour ajouter un partage à l’aide d’un autre fournisseur réseau (WebDAV ou partage DFS, par exemple), utilisez la fonction WNetAddConnection2 ou WNetAddConnection3 .

Si la fonction NetUseAdd retourne ERROR_INVALID_PARAMETER, vous pouvez utiliser le paramètre ParmError pour indiquer le premier membre de la structure d’informations non valide. (La structure d’informations commence par USE_INFO_ et son format est spécifié par le paramètre Level .) Le tableau suivant répertorie les valeurs qui peuvent être retournées dans le paramètre ParmError et le membre de structure correspondant qui est en erreur. (Le préfixe ui*_ indique que le membre peut commencer par plusieurs préfixes, par exemple ui1_ ou ui2_.)

Constant	Valeur	Membre
USE_LOCAL_PARMNUM	1	ui*_local
USE_REMOTE_PARMNUM	2	ui*_remote
USE_PASSWORD_PARMNUM	3	ui*_password
USE_ASGTYPE_PARMNUM	4	ui*_asg_type
USE_USERNAME_PARMNUM	5	ui*_username
USE_DOMAINNAME_PARMNUM	6	ui*_domainname

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmuse.h (include Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll