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

  • Статья

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

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

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

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Параметры

[in] servername

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

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

[in] level

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

Значение Значение
0
 Указывает сведения о протоколе транспорта рабочей станции. Параметр buf указывает на WKSTA_TRANSPORT_INFO_0 структуру.

[in] buf

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

[out] parm_err

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

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

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

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

Код возврата Описание
ERROR_ACCESS_DENIED
 Пользователь не имеет доступа к запрошенной информации.
ERROR_INVALID_LEVEL
 Недопустимый параметр level, который указывает, какой уровень сведений о структуре данных доступен.
ERROR_INVALID_PARAMETER
 Один из параметров функции недопустим.

Комментарии

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

Если функция NetWkstaTransportAdd возвращает ERROR_INVALID_PARAMETER, можно использовать параметр parm_err , чтобы указать недопустимый член структуры WKSTA_TRANSPORT_INFO_0 . В следующей таблице перечислены значения, которые могут быть возвращены в параметре parm_err и соответствующем элементе структуры с ошибкой.

Значение Член
TRANSPORT_QUALITYOFSERVICE_PARMNUM wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM wkti0_transport_name

Требования

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