NetServerTransportAdd, fonction (lmserver.h)

Article
03/01/2024

La fonction NetServerTransportAdd lie le serveur au protocole de transport.

La fonction étendue NetServerTransportAddEx permet à l’application appelante de spécifier les niveaux d’informations SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 et SERVER_TRANSPORT_INFO_3 .

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

Paramètres

[in] servername

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

[in] level

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

Valeur	Signification
0	Spécifie des informations sur le protocole de transport, notamment le nom, l’adresse et l’emplacement sur le réseau. Le paramètre bufptr pointe vers une structure SERVER_TRANSPORT_INFO_0 .

[in] bufptr

Pointeur vers la mémoire tampon qui contient les données.

Pour plus d’informations, consultez Mémoires tampons de fonction de gestion réseau.

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_DUP_NAME	Un nom en double existe sur le réseau.
ERROR_INVALID_DOMAINNAME	Le nom de domaine est introuvable sur le réseau.
ERROR_INVALID_LEVEL	La valeur spécifiée pour le paramètre level n’est pas valide.
ERROR_INVALID_PARAMETER	Un paramètre n'est pas valide. Cette erreur est retournée si le membre svti0_transportname ou svti0_transportaddress dans la structure SERVER_TRANSPORT_INFO_0 pointée par le paramètre bufptr est NULL. Cette erreur est également retournée si le membre svti0_transportaddresslength dans la structure SERVER_TRANSPORT_INFO_0 pointée par le paramètre bufptr est égal à zéro ou supérieur à MAX_PATH (défini dans le fichier d’en-tête Windef.h). Cette erreur est également retournée pour d’autres paramètres non valides.
ERROR_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante.

Remarques

Seuls les membres du groupe local Administrateurs ou Opérateurs de serveur peuvent exécuter correctement la fonction NetServerTransportAdd .

Si vous ajoutez un protocole de transport à un serveur à l’aide d’un appel à la fonction NetServerTransportAdd , la connexion ne restera pas après le redémarrage ou le redémarrage du serveur.

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	lmserver.h (include Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll