Функция NetUseAdd (lmuse.h)

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

Синтаксис

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

Параметры

[in] servername

UNC-имя компьютера, на котором выполняется эта функция. Если этот параметр имеет значение NULL, используется локальный компьютер. Если указанный параметр UncServerName является удаленным компьютером, удаленный компьютер должен поддерживать удаленные вызовы RPC с использованием устаревшего механизма протокола удаленного доступа.

Если определены _WIN32_WINNT или FORCE_UNICODE , это строка Юникода.

[in] LevelFlags

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

[in] buf

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

[out] parm_err

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

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

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

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

Комментарии

Вы также можете использовать функции WNetAddConnection2 и WNetAddConnection3 для перенаправления локального устройства в сетевой ресурс.

Для вызова функции NetUseAdd не требуется специальное членство в группе. Эта функция не может выполняться на удаленном сервере, за исключением случаев совместимости нижнего уровня.

Эта функция применяется только к клиенту server Message Block (LAN Manager Workstation). Функция NetUseAdd не поддерживает общие папки распределенной файловой системы (DFS). Чтобы добавить общую папку с помощью другого поставщика сети (например, WebDAV или общего ресурса DFS), используйте функцию WNetAddConnection2 или WNetAddConnection3 .

Если функция NetUseAdd возвращает ERROR_INVALID_PARAMETER, можно использовать параметр ParmError , чтобы указать, что первый недопустимый элемент информационной структуры. (Структура информации начинается с USE_INFO_, а ее формат задается параметром Level .) В следующей таблице перечислены значения, которые могут быть возвращены в параметре ParmError , и соответствующий элемент структуры, который находится в ошибке. (Префикс ui*_ указывает, что элемент может начинаться с нескольких префиксов, например ui1_ или ui2_.)

Требования

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

NetUseDel

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

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

USE_INFO_1

USE_INFO_2

Использование функций

WNetAddConnection2

WNetAddConnection3