NetWkstaTransportAdd, fonction (lmwksta.h)

Article
08/24/2023

[Cette fonction est obsolète. Pour modifier manuellement les paramètres par défaut des protocoles de transport, utilisez la boîte de dialogue Propriétés de connexion à la zone locale dans le dossier Connexions réseau et d’accès à distance .]

Non pris en charge.

La fonction NetWkstaTransportAdd lie (ou connecte) le redirecteur au transport. Le redirecteur est le logiciel sur l’ordinateur client qui génère des demandes de fichiers à l’ordinateur serveur.

Syntaxe

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

Paramètres

[in] servername

Pointeur vers une chaîne qui spécifie le nom DNS ou NetBIOS du serveur distant sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

Cette chaîne doit commencer par \.

[in] level

Spécifie le niveau d’informations des données. Ce paramètre peut être la valeur suivante.

Valeur	Signification
0	Spécifie les informations sur le protocole de transport de la station de travail. Le paramètre buf pointe vers une structure WKSTA_TRANSPORT_INFO_0 .

[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 de niveau . 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 paramètre qui provoque l’erreur ERROR_INVALID_PARAMETER. Si ce paramètre a la valeur NULL, l’index n’est pas retourné en cas d’erreur.

Valeur retournée

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

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_ACCESS_DENIED	L’utilisateur n’a pas accès aux informations demandées.
ERROR_INVALID_LEVEL	Le paramètre level, qui indique le niveau d’informations de structure de données disponible, n’est pas valide.
ERROR_INVALID_PARAMETER	L’un des paramètres de fonction n’est pas valide.

Notes

Seuls les membres du groupe local Administrateurs peuvent exécuter correctement la fonction NetWkstaTransportAdd .

Si la fonction NetWkstaTransportAdd retourne ERROR_INVALID_PARAMETER, vous pouvez utiliser le paramètre parm_err pour indiquer le membre de la structure WKSTA_TRANSPORT_INFO_0 qui n’est pas valide. Le tableau suivant répertorie les valeurs qui peuvent être retournées dans le paramètre parm_err et le membre de structure correspondant qui est en erreur.

Valeur	Membre
TRANSPORT_QUALITYOFSERVICE_PARMNUM	wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM	wkti0_transport_name

Spécifications


Plateforme cible	Windows
En-tête	lmwksta.h (inclure Lm.h, Lmwksta.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll

Partager via