NetServerTransportAdd

The NetServerTransportAdd function binds the server to the transport protocol.

The extended function NetServerTransportAddEx allows the calling application to specify the SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2, and SERVER_TRANSPORT_INFO_3 information levels.

Security Requirements

Only members of the Administrators local group can successfully execute the NetServerTransportAdd function.

NET_API_STATUS NetServerTransportAdd(
  LPWSTR servername,  
  DWORD level,        
  LPBYTE bufptr       
);

Parameters

servername

[in] Pointer to a Unicode string specifying the name of the remote server on which the function is to execute. The string must begin with \\. If this parameter is NULL, the local computer is used.

level

[in] Specifies the information level of the data. This parameter can be the following value.

Value	Meaning
0	Specifies information about the transport protocol, including name, address, and location on the network. The bufptr parameter points to a SERVER_TRANSPORT_INFO_0 structure.

bufptr

[in] Pointer to the buffer that specifies the data. The format of this data depends on the value of the level parameter.

Return Values

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value can be one of the following error codes.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Lmserver.h; include Lm.h.
  Library: Use Netapi32.lib.

See Also

Network Management Overview, Network Management Functions, Server and Workstation Transport Functions, NetServerTransportDel, NetServerTransportAddEx, SERVER_TRANSPORT_INFO_0