Поделиться через


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

Функция NetServerTransportAdd привязывает сервер к транспортному протоколу.

Расширенная функция NetServerTransportAddEx позволяет вызывающей приложению указать уровни SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 и SERVER_TRANSPORT_INFO_3 .

Синтаксис

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

Параметры

[in] servername

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

[in] level

Указывает уровень информации о данных. Этот параметр может иметь следующее значение.

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

[in] bufptr

Указатель на буфер, содержащий данные.

Дополнительные сведения см. в разделе Буферы функций управления сетью.

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

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

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

Код возврата Описание
ERROR_ACCESS_DENIED
У пользователя нет доступа к запрошенной информации.
ERROR_DUP_NAME
В сети существует повторяющееся имя.
ERROR_INVALID_DOMAINNAME
Не удалось найти доменное имя в сети.
ERROR_INVALID_LEVEL
Значение, указанное для параметра level , является недопустимым.
ERROR_INVALID_PARAMETER
Недопустимый параметр.

Эта ошибка возвращается, если элемент svti0_transportname или svti0_transportaddress в структуре SERVER_TRANSPORT_INFO_0 , на которую указывает параметр bufptr , имеет значение NULL. Эта ошибка также возвращается, если элемент svti0_transportaddresslength в структуре SERVER_TRANSPORT_INFO_0 , на которую указывает параметр bufptr , равен нулю или больше MAX_PATH (определяется в файле заголовка Windef.h).

Эта ошибка также возвращается для других недопустимых параметров.

ERROR_NOT_ENOUGH_MEMORY
Недостаточно памяти.

Комментарии

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

При добавлении транспортного протокола на сервер с помощью вызова функции NetServerTransportAdd подключение не останется после перезагрузки или перезагрузки сервера.

Требования

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

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

NetServerComputerNameAdd

NetServerComputerNameDel

NetServerTransportAddEx

NetServerTransportDel

NetServerTransportEnum

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

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

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

SERVER_TRANSPORT_INFO_2

SERVER_TRANSPORT_INFO_3

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