structure SERVER_TRANSPORT_INFO_3 (lmserver.h)

Article
08/24/2023

La structure SERVER_TRANSPORT_INFO_3 contient des informations sur le protocole de transport spécifié, notamment le nom, l’adresse et le mot de passe (informations d’identification). Ce niveau d’informations est valide uniquement pour la fonction NetServerTransportAddEx .

Syntaxe

typedef struct _SERVER_TRANSPORT_INFO_3 {
  DWORD  svti3_numberofvcs;
  LMSTR  svti3_transportname;
  LPBYTE svti3_transportaddress;
  DWORD  svti3_transportaddresslength;
  LMSTR  svti3_networkaddress;
  LMSTR  svti3_domain;
  ULONG  svti3_flags;
  DWORD  svti3_passwordlength;
  BYTE   svti3_password[256];
} SERVER_TRANSPORT_INFO_3, *PSERVER_TRANSPORT_INFO_3, *LPSERVER_TRANSPORT_INFO_3;

Membres

svti3_numberofvcs

Type : DWORD

Nombre de clients connectés au serveur qui utilisent le protocole de transport spécifié par le membre svti3_transportname .

svti3_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.

svti3_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 svti3_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).

svti3_transportaddresslength

Type : DWORD

Longueur, en octets, du membre svti3_transportaddress . Pour les noms NetBIOS, la valeur de ce membre est 16 (décimal).

svti3_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.

svti3_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.

svti3_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.

svti3_passwordlength

Type : DWORD

Nombre d’octets valides dans le membre svti3_password .

svti3_password[256]

Type : BYTE[256]

Informations d’identification à utiliser pour la nouvelle adresse de transport. Si le membre svti3_passwordlength est égal à zéro, les informations d’identification du serveur sont utilisées.

Notes

La structure SERVER_TRANSPORT_INFO_3 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 de « MyServer » dans le membre svti3_transportaddress et SVTI2_REMAP_PIPE_NAMES dans le membre svti3_flags . Lorsqu’un client tente d’ouvrir « Pipe » sur « \MyServer », le client ouvre $$MyServer\Pipe à la place.

Les membres svti3_passwordlength et svti3_password sont nécessaires pour qu’un client et un serveur effectuent l’authentification mutuelle.

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)