Функция WSCUnInstallNameSpace (ws2spi.h)

Статья
03/04/2024

Функция WSCUnInstallNameSpace удаляет указанный поставщик пространства имен.

Синтаксис

INT WSCUnInstallNameSpace(
  [in] LPGUID lpProviderId
);

Параметры

[in] lpProviderId

Указатель на глобальный уникальный идентификатор (GUID) для удаляемого поставщика пространства имен.

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

Если ошибка не возникает, WSCUnInstallNameSpace возвращает NO_ERROR (ноль). В противном случае он возвращает SOCKET_ERROR , если функция завершается сбоем, и необходимо получить соответствующий код ошибки с помощью функции WSAGetLastError .

Код ошибки	Значение
WSAEFAULT	Параметр lpProviderId указывает на память, которая не находится в допустимой части адресного пространства пользователя.
WSAEINVAL	Указанный идентификатор поставщика пространства имен недопустим.
WSASYSCALLFAILURE	Системный вызов, который никогда не должен завершать ошибку, завершился сбоем.
WSA_NOT_ENOUGH_MEMORY	Недостаточно памяти. Эта ошибка возвращается при нехватке памяти для выделения новой записи каталога.

Функции конфигурации пространства имен не влияют на уже запущенные приложения. Недавно установленные поставщики пространства имен не будут видны приложениям, а также изменения в состоянии активации поставщика пространства имен. Приложения, запущенные после вызова WSCUnInstallNameSpace , увидят изменения.

При успешном выполнении WSCUnInstallNameSpace попытается оповещать все заинтересованные приложения, зарегистрированные для уведомления об изменении, вызвав WSAProviderConfigChange.

Функция WSCUnInstallNameSpace может вызываться только пользователем, вошедшим в систему как член группы администраторов. Если WSCUnInstallNameSpace вызывается пользователем, который не является членом группы администраторов, вызов функции завершится ошибкой и WSANO_RECOVERY возвращается в параметре lpErrno .

Для компьютеров под управлением Windows Vista или Windows Server 2008 эта функция также может завершиться ошибкой из-за контроля учетных записей пользователей (UAC). Если приложение, содержащее эту функцию, выполняется пользователем, вошедшего в систему как член группы администраторов, отличный от встроенного администратора, этот вызов завершится ошибкой, если приложение не было отмечено в файле манифеста с параметром requestedExecutionLevel , для которого задано значение requireAdministrator. Если в приложении в Windows Vista или Windows Server 2008 отсутствует этот файл манифеста, пользователь, вошедший в систему как член группы администраторов, отличный от встроенного администратора, должен выполнить приложение в расширенной оболочке в качестве встроенного администратора (администратора запуска от имени администратора), чтобы эта функция была успешно выполнена.

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

Требования

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