Функция 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
Указывает уровень информации о данных. Этот параметр может иметь следующее значение.
| Значение | Значение |
|---|---|
|
Указывает сведения о транспортном протоколе, включая имя, адрес и расположение в сети. Параметр bufptr указывает на структуру SERVER_TRANSPORT_INFO_0 . |
[in] bufptr
Указатель на буфер, содержащий данные.
Дополнительные сведения см. в разделе Буферы функций управления сетью.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет NERR_Success.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов ошибок.
| Код возврата | Описание |
|---|---|
|
У пользователя нет доступа к запрошенной информации. |
|
В сети существует повторяющееся имя. |
|
Не удалось найти доменное имя в сети. |
|
Значение, указанное для параметра level , является недопустимым. |
|
Недопустимый параметр.
Эта ошибка возвращается, если элемент svti0_transportname или svti0_transportaddress в структуре SERVER_TRANSPORT_INFO_0 , на которую указывает параметр bufptr , имеет значение NULL. Эта ошибка также возвращается, если элемент svti0_transportaddresslength в структуре SERVER_TRANSPORT_INFO_0 , на которую указывает параметр bufptr , равен нулю или больше MAX_PATH (определяется в файле заголовка Windef.h). Эта ошибка также возвращается для других недопустимых параметров. |
|
Недостаточно памяти. |
Комментарии
Только члены локальной группы Администраторы или Операторы сервера могут успешно выполнять функцию NetServerTransportAdd .
При добавлении транспортного протокола на сервер с помощью вызова функции NetServerTransportAdd подключение не останется после перезагрузки или перезагрузки сервера.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | lmserver.h (включая Lm.h) |
| Библиотека | Netapi32.lib |
| DLL | Netapi32.dll |