structure SERVER_TRANSPORT_INFO_2 (lmserver.h)

Article
08/24/2023

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 .

Valeur	Signification
SVTI2_REMAP_PIPE_NAMES	Si cette valeur est définie pour un point de terminaison, les demandes clientes arrivant via le transport pour ouvrir un canal nommé sont redirigées (remappées) vers le nom de canal local suivant : $$\ServerName\PipeName Pour plus d’informations sur l’utilisation de cette valeur, consultez la section Remarques.
SVTI2_SCOPED_NAME	Si cette valeur est définie pour un point de terminaison et qu’il y a une tentative de création d’un second transport avec la même adresse réseau, mais un nom de transport différent et des paramètres en conflit pour l’indicateur SCOPED, cette création de transport échouera. Ainsi, chaque transport inscrit pour une adresse réseau donnée doit avoir le même paramètre d’étendue. Pour plus d’informations sur l’utilisation de cette valeur, consultez la section Remarques. Cette valeur est définie sur Windows Server 2008 et Windows Vista avec SP1.

Valeur

Signification

SVTI2_REMAP_PIPE_NAMES

Si cette valeur est définie pour un point de terminaison, les demandes clientes arrivant via le transport pour ouvrir un canal nommé sont redirigées (remappées) vers le nom de canal local suivant :

$$\ServerName\PipeName

Pour plus d’informations sur l’utilisation de cette valeur, consultez la section Remarques.

SVTI2_SCOPED_NAME

Si cette valeur est définie pour un point de terminaison et qu’il y a une tentative de création d’un second transport avec la même adresse réseau, mais un nom de transport différent et des paramètres en conflit pour l’indicateur SCOPED, cette création de transport échouera. Ainsi, chaque transport inscrit pour une adresse réseau donnée doit avoir le même paramètre d’étendue.

Pour plus d’informations sur l’utilisation de cette valeur, consultez la section Remarques.

Cette valeur est définie sur Windows Server 2008 et Windows Vista avec SP1.

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)