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

Статья
08/24/2023

Функция 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

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

Значение	Значение
1	Указывает сведения о подключении между локальным устройством и общим ресурсом. Сведения о состоянии и типе подключения. Параметр Buf является указателем на структуру USE_INFO_1 .
2	Указывает сведения о подключении между локальным устройством и общим ресурсом. Сведения включают состояние и тип подключения, а также имя пользователя и доменное имя. Параметр Buf является указателем на структуру USE_INFO_2 .

Значение

1

Указывает сведения о подключении между локальным устройством и общим ресурсом. Сведения о состоянии и типе подключения. Параметр Buf является указателем на структуру USE_INFO_1 .

2

Указывает сведения о подключении между локальным устройством и общим ресурсом. Сведения включают состояние и тип подключения, а также имя пользователя и доменное имя. Параметр Buf является указателем на структуру USE_INFO_2 .

[in] buf

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

[out] parm_err

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

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

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

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

Для вызова функции 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_.)

Константа	Значение	Член
USE_LOCAL_PARMNUM	1	пользовательский интерфейс*_local
USE_REMOTE_PARMNUM	2	пользовательский интерфейс*_remote
USE_PASSWORD_PARMNUM	3	пользовательский интерфейс*_password
USE_ASGTYPE_PARMNUM	4	пользовательский интерфейс*_asg_type
USE_USERNAME_PARMNUM	5	пользовательский интерфейс*_username
USE_DOMAINNAME_PARMNUM	6	пользовательский интерфейс*_domainname

Требования

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