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

Статья
02/28/2024

Функция 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	Недостаточно памяти.

Требования

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