Поделиться через

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

  • Статья

Функция WSCEnableNSProvider изменяет состояние заданного поставщика пространства имен. Он предназначен для того, чтобы предоставить конечному пользователю возможность изменять состояние поставщиков пространства имен.

Синтаксис

INT WSCEnableNSProvider(
  [in] LPGUID lpProviderId,
  [in] BOOL   fEnable
);

Параметры

[in] lpProviderId

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

[in] fEnable

Логическое значение, которое, если значение TRUE, поставщику присваивается активное состояние. Если значение FALSE, поставщик отключен и не будет доступен для операций запроса или регистрации службы.

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

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

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

Комментарии

Функция WSCEnableNSProvider предназначена для изменения состояния поставщиков пространства имен. Независимый поставщик программного обеспечения (ISV) обычно не должен отменять активацию другого поставщика пространств имен ISV для активации собственного поставщика. Выбор должен быть оставлен за пользователем.

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

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

Для компьютеров под управлением 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

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

WSCEnumProtocols

WSCInstallNameSpace

WSCUnInstallNameSpace

WSCWriteNameSpaceOrder