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

Функция NetWkstaTransportDel (lmwksta.h)

  • Статья

[Эта функция устарела. Чтобы изменить параметры по умолчанию для транспортных протоколов вручную, используйте диалоговое окно Свойства подключения по локальной сети в папке сеть и удаленное подключение Connections.]

Не поддерживается.

Функция NetWkstaTransportDel отменяет привязку транспортного протокола к перенаправлению. (Перенаправитель — это программное обеспечение на клиентском компьютере, которое создает запросы файлов к компьютеру сервера.)

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportDel(
  [in] LMSTR servername,
  [in] LMSTR transportname,
  [in] DWORD ucond
);

Параметры

[in] servername

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

Эта строка должна начинаться с \.

[in] transportname

Указатель на строку, указывающую имя транспортного протокола, отключаемого от перенаправителя.

[in] ucond

Указывает уровень силы, используемый при отключении транспортного протокола от перенаправителя. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
USE_NOFORCE
 Если в подключении существуют открытые файлы, завершится сбоем.
USE_FORCE
 Если в подключении существуют открытые файлы, завершится сбоем.
USE_LOTS_OF_FORCE
 Закройте все открытые файлы и удалите подключение.

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

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

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

Код возврата Описание
ERROR_ACCESS_DENIED
 Пользователь не имеет доступа к запрошенной информации.
ERROR_INVALID_PARAMETER
 Один из параметров функции недопустим.
NERR_UseNotFound
 Сетевое подключение не существует.

Комментарии

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

Требования

Требование Значение
Целевая платформа Windows
Header lmwksta.h (включая Lm.h, Lmwksta.h)
Библиотека Netapi32.lib
DLL Netapi32.dll