NetServerTransportDel

The NetServerTransportDel function unbinds (or disconnects) the transport protocol from the server. Effectively, the server can no longer communicate with clients using the specified transport protocol (such as TCP, NetBEUI, and XNS).

Security Requirements

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

NET_API_STATUS NetServerTransportDel(
  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 one of the following values.

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.
1	Specifies information about the transport protocol, including name, address, network location, and domain. The bufptr parameter points to a SERVER_TRANSPORT_INFO_1 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, NetServerTransportAdd, SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1