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

Функция WSCInstallNameSpace32 устанавливает указанный 32-разрядный поставщик пространства имен. Для поставщиков, которые могут поддерживать несколько пространств имен, эта функция должна вызываться для каждого поддерживаемого пространства имен и каждый раз предоставлять уникальный идентификатор поставщика.

Синтаксис

INT WSCInstallNameSpace32(
  [in] LPWSTR lpszIdentifier,
  [in] LPWSTR lpszPathName,
  [in] DWORD  dwNameSpace,
  [in] DWORD  dwVersion,
  [in] LPGUID lpProviderId
);

Параметры

[in] lpszIdentifier

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

[in] lpszPathName

Указатель на строку, содержащую путь к dll-образу поставщика. Строка соблюдает обычные правила разрешения пути: этот путь может содержать строки внедренной среды (например, %SystemRoot%). Такие строки среды расширяются всякий раз, когда WS2_32.DLL должен впоследствии загрузить библиотеку DLL поставщика от имени приложения. После развертывания строк внедренной среды Ws2_32.dll передает полученную строку в функцию LoadLibrary для загрузки поставщика в память. Дополнительные сведения см. в разделе LoadLibrary.

[in] dwNameSpace

Дескриптор, указывающий пространство имен, поддерживаемое этим поставщиком.

[in] dwVersion

Дескриптор, указывающий номер версии поставщика.

[in] lpProviderId

Уникальный идентификатор для этого поставщика. Этот GUID должен быть создан Uuidgen.exe.

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

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

Комментарии

WSCInstallNameSpace32 — это строго 32-разрядная версия WSCInstallNameSpace. На 64-разрядном компьютере все вызовы, не относящиеся к 32-разрядным (например, все функции, которые не заканчиваются на "32"), работают в собственном 64-разрядном каталоге. Процессы, выполняемые на 64-разрядном компьютере, должны использовать определенные вызовы 32-разрядных функций для работы с строго 32-разрядным каталогом и сохранения совместимости. Определения и семантика конкретных 32-разрядных вызовов совпадают с собственными аналогами.

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

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

Требования

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

WSCDeinstallProvider32

WSCEnumProtocols32

WSCInstallNameSpace

WSCInstallNameSpaceEx32

WSCUnInstallNameSpace32