Функция NetShareDelEx (lmshare.h)

Статья
08/24/2023

Удаляет имя общей папки из списка общих ресурсов сервера, что отключает все подключения к этой общей папке. Эта функция, являющаяся расширенной версией функции NetShareDel , позволяет вызывающей объекту указать структуру SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2, SHARE_INFO_502 или SHARE_INFO_503 .

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE buf
);

Параметры

[in] servername

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

Эта строка имеет значение Юникод, если определен _WIN32_WINNT или FORCE_UNICODE .

[in] level

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

Значение	Значение
0, 1, 2 или 502	Указывает сведения об общем ресурсе, включая имя ресурса, тип и разрешения, а также количество подключений. Параметр buf указывает на структуру SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 или SHARE_INFO_502 .
503	Указывает сведения об общем ресурсе, включая имя ресурса, тип и разрешения, количество подключений и другие важные сведения. Параметр buf указывает на структуру SHARE_INFO_503 .

[in] buf

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

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

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

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

Код возврата	Описание
ERROR_INTERNAL_ERROR	Внутренняя ошибка.
ERROR_INVALID_LEVEL	Недопустимое значение, указанное для параметра level .
ERROR_NOT_SUPPORTED	Запрос не поддерживается.

Если для параметра level задано значение 503, то параметр buf указывает на SHARE_INFO_503 структуру, а shi503_netname и shi503_servername члены этой структуры используются для поиска общего ресурса на сервере; остальные элементы игнорируются. Удаленный сервер, указанный в элементе shi503_servername , должен быть привязан к транспортному протоколу с помощью функции NetServerTransportAddEx . В вызове NetServerTransportAddEx для параметра level должно быть указано значение 2 или 3, а флаг SVTI2_SCOPED_NAME должен быть указан в структуре SERVER_TRANSPORT_INFO_2 транспортного протокола.

Если для параметра level задано значение 0, 1, 2 или 502, то параметр buf указывает на структуру SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 или SHARE_INFO_502 и используется элемент shi0_netname, shi1_netname, shi2_netname или shi502_netname этой структуры; остальные элементы игнорируются.

Требования

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