NetServerTransportAddEx, fonction (lmserver.h)

Article
08/24/2023

La fonction NetServerTransportAddEx lie le serveur spécifié au protocole de transport. Cette fonction étendue permet à l’application appelante de spécifier les niveaux d’informations SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 .

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetServerTransportAddEx(
  [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 une valeur qui indique le niveau d’informations des données. Ce paramètre peut prendre les valeurs suivantes.

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 .
1	Spécifie des informations sur le protocole de transport, notamment le nom, l’adresse, l’emplacement réseau et le domaine. Le paramètre bufptr pointe vers une structure SERVER_TRANSPORT_INFO_1 .
2	Spécifie les mêmes informations que le niveau 1, avec l’ajout d’un membre svti2_flags . Le paramètre bufptr pointe vers une structure SERVER_TRANSPORT_INFO_2 .
3	Spécifie les mêmes informations que le niveau 2, avec l’ajout d’informations d’identification. Le paramètre bufptr pointe vers une structure SERVER_TRANSPORT_INFO_3 .

[in] bufptr

Pointeur vers la mémoire tampon qui contient 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.

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 de niveau n’est pas valide.
ERROR_INVALID_PARAMETER	Un paramètre n'est pas valide. Cette erreur est retournée si le nom de transport ou le membre d’adresse de transport dans le SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 structure pointée par le paramètre bufptr est NULL. Cette erreur est également retournée si le membre de longueur d’adresse de transport dans le SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 structure pointée par le paramètre bufptr est égal ou supérieur à MAX_PATH (défini dans le fichier d’en-tête Windef.h ). Cette erreur est également retournée si le membre des indicateurs du SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 structure pointée par le paramètre bufptr contient une valeur non conforme. Cette erreur est également retournée pour d’autres paramètres non valides.
ERROR_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante.

Notes

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

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

La fonction NetServerComputerNameAdd est une fonction utilitaire. Il combine les fonctionnalités de la fonction NetServerTransportEnum et de la fonction NetServerTransportAddEx , ce qui vous permet de spécifier un nom de serveur émulé.

Sur Windows Server 2008 et Windows Vista avec Service Pack 1 (SP1), chaque nom inscrit auprès du serveur de fichiers distant Windows (SRV) est désigné comme un nom délimité ou un nom non délimité. Chaque partage ajouté au système sera alors soit attaché à tous les noms non délimités, soit à un seul nom délimité. Les applications qui souhaitent utiliser les fonctionnalités d’étendue sont responsables à la fois de l’inscription du nouveau nom en tant que point de terminaison délimité, puis de la création des partages avec une étendue appropriée. De cette façon, les utilisations héritées des fonctions Gestion du réseau et Gestion des partages réseau ne sont en aucun cas affectées, car elles continuent d’inscrire des partages et des noms en tant que noms non délimités.

Un point de terminaison délimité est créé en appelant la fonction NetServerTransportAddEx avec le paramètre de niveau défini sur 2 et le paramètre bufptr pointé vers une structure SERVER_TRANSPORT_INFO_2 avec la valeur de bit SVTI2_SCOPED_NAME définie dans svti2_flags membre. Un point de terminaison délimité est également créé en appelant la fonction NetServerTransportAddEx avec le paramètre de niveau défini sur 3 et le paramètre bufptr pointé vers une structure SERVER_TRANSPORT_INFO_3 avec la valeur de bits SVTI2_SCOPED_NAME définie dans svti3_flags membre.

Lorsque la valeur de bits SVTI2_SCOPED_NAME est définie pour un transport, les partages peuvent être ajoutés avec un nom de serveur correspondant (le membre shi503_servername de la structure SHARE_INFO_503 ) de manière étendue à l’aide de la fonction NetShareAdd . S’il n’y a pas de transport inscrit avec la valeur de bit SVTI2_SCOPED_NAME et le nom fourni dans shi503_servername membre, l’ajout de partage d’une manière délimitée n’aboutira pas.

La fonction NetShareAdd est utilisée pour ajouter un partage délimité sur un serveur distant spécifié dans le paramètre servername . Le serveur distant spécifié dans le membre shi503_servername du SHARE_INFO_503 passé dans le paramètre bufptr doit avoir été lié à un protocole de transport utilisant la fonction NetServerTransportAddEx comme point de terminaison délimité. L’indicateur SVTI2_SCOPED_NAME doit avoir été spécifié dans le membre shi503_servername de la structure SERVER_TRANSPORT_INFO_2 ou SERVER_TRANSPORT_INFO_3 pour le protocole de transport. La fonction NetShareDelEx est utilisée pour supprimer un partage délimité. Les fonctions NetShareGetInfo et NetShareSetInfo sont utilisées pour obtenir et définir des informations sur un partage délimité.

Les points de terminaison délimités sont généralement utilisés par l’espace de noms du cluster.

Spécifications


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