Функция NetServerTransportDel (lmserver.h)

Функция NetServerTransportDel отменяет привязку (или отключает) транспортный протокол от сервера. Фактически сервер больше не может взаимодействовать с клиентами по указанному транспортному протоколу (например, TCP или XNS).

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetServerTransportDel(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

Параметры

[in] servername

Указатель на строку, указывающую DNS- или NetBIOS-имя удаленного сервера, на котором выполняется функция. Если этот параметр имеет значение NULL, используется локальный компьютер.

[in] level

Задает уровень информации данных. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
0
Указывает сведения о транспортном протоколе, включая имя, адрес и расположение в сети. Параметр bufptr указывает на SERVER_TRANSPORT_INFO_0 структуру.
1
Указывает сведения о транспортном протоколе, включая имя, адрес, сетевое расположение и домен. Параметр bufptr указывает на структуру SERVER_TRANSPORT_INFO_1 .

[in] bufptr

Указатель на буфер, указывающий данные. Формат этих данных зависит от значения параметра level . Дополнительные сведения см. в разделе Буферы функций управления сетью.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NERR_Success.

Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих кодов ошибок.

Код возврата Описание
ERROR_ACCESS_DENIED
Пользователь не имеет доступа к запрошенной информации.
ERROR_INVALID_LEVEL
Недопустимое значение, указанное для параметра level .
ERROR_INVALID_PARAMETER
Указанный параметр недопустим.
ERROR_NOT_ENOUGH_MEMORY
Недостаточно памяти.
NERR_NetNameNotFound
Имя общей папки не существует.

Комментарии

Только члены локальной группы Администраторы или Операторы сервера могут успешно выполнять функцию NetServerTransportDel .

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header lmserver.h (включая Lm.h)
Библиотека Netapi32.lib
DLL Netapi32.dll

См. также раздел

NetServerTransportAdd

Функции управления сетью

Общие сведения об управлении сетью

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

Функции транспорта сервера и рабочей станции