Platform SDK: Network Management

SERVER_TRANSPORT_INFO_3

The SERVER_TRANSPORT_INFO_3 structure contains information about the specified transport protocol, including name, address and password (credentials). This information level is valid only for the NetServerTransportAddEx function.

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

Members

svti3_numberofvcs
Specifies a DWORD value that indicates the number of clients connected to the server that are using the transport protocol specified by the svti3_transportname member.
svti3_transportname
Pointer to a null-terminated character string that contains the name of a Windows NT transport device; for example,
\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}
svti3_transportaddress
Pointer to a variable that contains the address the server is using on the transport device specified by the svti3_transportname member.

This member is usually the NetBIOS name that the server is using. In these instances, the name must be 16 characters long, and the last character must be a blank character (0x20).

svti3_transportaddresslength
Specifies a DWORD value that contains the length, in bytes, of the svti3_transportaddress member. For NetBIOS names, the value of this member is 16 (decimal).
svti3_networkaddress
Pointer to a null-terminated character string that contains the address the network adapter is using. The string is transport-specific. (You can retrieve this value only with a call to the NetServerTransportEnum function. You cannot set this value with a call to the NetServerTransportAdd function or the NetServerTransportAddEx function.)
svti3_domain
Pointer to a null-terminated character string that contains the name of the domain to which the server should announce its presence. (When you call NetServerTransportEnum, this member is the name of the domain to which the server is announcing its presence.)
svti3_flags
This member can be the following value.
Value Meaning
SVTI2_REMAP_PIPE_NAMES If this value is set for an endpoint, client requests arriving over the transport to open a named pipe are rerouted (remapped) to the local pipe name $$\ServerName\PipeName.

svti3_passwordlength
Specifies a DWORD value that indicates the number of valid bytes in the svti3_password member.
svti3_password
Specifies the credentials to use for the new transport address. If the svti3_passwordlength member is zero, the credentials for the server are used.

Remarks

For an example of the use of the SVTI2_REMAP_PIPE_NAMES value see SERVER_TRANSPORT_INFO_2.

The svti3_passwordlength and svti3_password members are necessary for a client and server to perform mutual authentication.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Lmserver.h.

See Also

Network Management Overview, Network Management Structures, Server and Workstation Transport Functions, NetServerTransportAddEx, NetServerTransportAdd, NetServerTransportDel, NetServerTransportEnum, SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2