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

  • Статья

Функция NetUseDel завершает подключение к общему ресурсу.

Для завершения сетевого подключения можно также использовать функцию WNetCancelConnection2 .

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

Параметры

[in] UncServerName

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

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

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

[in] UseName

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

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

[in] ForceLevelFlags

Уровень силы, используемый при удалении соединения.

Этот параметр может быть одним из следующих значений, определенных в файле заголовка lmuseflg.h .

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

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

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

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

Комментарии

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

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

Требования

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

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

NetUseAdd

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

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

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

WNetCancelConnection2