Функция WSCUnInstallNameSpace (ws2spi.h)
Функция WSCUnInstallNameSpace удаляет указанный поставщик пространства имен.
Синтаксис
INT WSCUnInstallNameSpace(
[in] LPGUID lpProviderId
);
Параметры
[in] lpProviderId
Указатель на глобальный уникальный идентификатор (GUID) для удаляемого поставщика пространства имен.
Возвращаемое значение
Если ошибка не возникает, WSCUnInstallNameSpace возвращает NO_ERROR (ноль). В противном случае он возвращает SOCKET_ERROR , если функция завершается сбоем, и необходимо получить соответствующий код ошибки с помощью функции WSAGetLastError .
| Код ошибки | Значение |
|---|---|
| Параметр lpProviderId указывает на память, которая не находится в допустимой части адресного пространства пользователя. | |
| Указанный идентификатор поставщика пространства имен недопустим. | |
| Системный вызов, который никогда не должен завершать ошибку, завершился сбоем. | |
| Недостаточно памяти. Эта ошибка возвращается при нехватке памяти для выделения новой записи каталога. |
Комментарии
Функции конфигурации пространства имен не влияют на уже запущенные приложения. Недавно установленные поставщики пространства имен не будут видны приложениям, а также изменения в состоянии активации поставщика пространства имен. Приложения, запущенные после вызова 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 |