structure SERVER_TRANSPORT_INFO_2 (lmserver.h)
La structure SERVER_TRANSPORT_INFO_2 contient des informations sur le protocole de transport spécifié, y compris le nom et l’adresse du transport. Ce niveau d’informations est valide uniquement pour la fonction NetServerTransportAddEx .
Syntaxe
typedef struct _SERVER_TRANSPORT_INFO_2 {
DWORD svti2_numberofvcs;
LMSTR svti2_transportname;
LPBYTE svti2_transportaddress;
DWORD svti2_transportaddresslength;
LMSTR svti2_networkaddress;
LMSTR svti2_domain;
ULONG svti2_flags;
} SERVER_TRANSPORT_INFO_2, *PSERVER_TRANSPORT_INFO_2, *LPSERVER_TRANSPORT_INFO_2;
Membres
svti2_numberofvcs
Type : DWORD
Nombre de clients connectés au serveur qui utilisent le protocole de transport spécifié par le membre svti2_transportname .
svti2_transportname
Type : LMSTR
Pointeur vers une chaîne de caractères terminée par NULL qui contient le nom d’un périphérique de transport ; par exemple,
\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}
Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.
svti2_transportaddress
Type : LPBYTE
Pointeur vers une variable qui contient l’adresse que le serveur utilise sur le périphérique de transport spécifié par le membre svti2_transportname .
Ce membre est généralement le nom NetBIOS utilisé par le serveur. Dans ces cas, le nom doit contenir 16 caractères et le dernier caractère doit être un caractère vide (0x20).
svti2_transportaddresslength
Type : DWORD
Longueur, en octets, du membre svti2_transportaddress . Pour les noms NetBIOS, la valeur de ce membre est 16 (décimal).
svti2_networkaddress
Type : LMSTR
Pointeur vers une chaîne de caractères terminée par null qui contient l’adresse utilisée par la carte réseau. La chaîne est spécifique au transport.
Vous pouvez récupérer cette valeur uniquement avec un appel à la fonction NetServerTransportEnum . Vous ne pouvez pas définir cette valeur avec un appel à la fonction NetServerTransportAdd ou à la fonction NetServerTransportAddEx .)
Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.
svti2_domain
Type : LMSTR
Pointeur vers une chaîne de caractères terminée par null qui contient le nom du domaine auquel le serveur doit annoncer sa présence. (Lorsque vous appelez NetServerTransportEnum, ce membre est le nom du domaine auquel le serveur annonce sa présence.)
Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.
svti2_flags
Type : ULONG
Ce membre peut être une combinaison des valeurs de bits suivantes définies dans le fichier d’en-tête Lmserver.h .
Notes
La structure SERVER_TRANSPORT_INFO_2 est utilisée par la fonction NetServerTransportAddEx pour lier le serveur spécifié au protocole de transport.
Voici un exemple d’utilisation de la valeur SVTI2_REMAP_PIPE_NAMES. Appelez la fonction NetServerTransportAddEx pour ajouter un transport au serveur, en spécifiant l’adresse « MyServer » dans le membre svti2_transportaddress et SVTI2_REMAP_PIPE_NAMES dans le membre svti2_flags . Lorsqu’un client tente d’ouvrir « Pipe » sur « \MyServer », le client ouvre $$MyServer\Pipe à la place.
Sur Windows Server 2008 et Windows Vista avec SP1, chaque nom inscrit auprès du serveur de fichiers distants 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] |
| En-tête | lmserver.h (include Lm.h) |