SERVER_TRANSPORT_INFO_2

The SERVER_TRANSPORT_INFO_2 structure contains information about the specified transport protocol, including name and address. This information level is valid only for the NetServerTransportAddEx function.

typedef struct _SERVER_TRANSPORT_INFO_2 {
  DWORD     svti2_numberofvcs;
  LPSTR     svti2_transportname;
  LPBYTE    svti2_transportaddress;
  DWORD     svti2_transportaddresslength;
  LPSTR     svti2_networkaddress;
  LPSTR     svti2_domain;
  ULONG     svti2_flags;
} SERVER_TRANSPORT_INFO_2, *PSERVER_TRANSPORT_INFO_2, *LPSERVER_TRANSPORT_INFO_2;

Members

svti2_numberofvcs

Specifies a DWORD value that indicates the number of clients connected to the server that are using the transport protocol specified by the svti2_transportname member.

svti2_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}

svti2_transportaddress

Pointer to a variable that contains the address the server is using on the transport device specified by the svti2_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).

svti2_transportaddresslength

Specifies a DWORD value that contains the length, in bytes, of the svti2_transportaddress member. For NetBIOS names, the value of this member is 16 (decimal).

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

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

svti2_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. For more information, see the following Remarks section.

Remarks

An example of the use of the SVTI2_REMAP_PIPE_NAMES value follows. Call the NetServerTransportAddEx function to add a transport to the server, specifying the address of "MyServer" in the svti2_transportaddress member, and SVTI2_REMAP_PIPE_NAMES in the svti2_flags member. When a client attempts to open "Pipe" on "\\MyServer" the client will actually open $$\MyServer\Pipe instead.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  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