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

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

  • Статья

Функция WSCGetProviderPath извлекает путь DLL для указанного поставщика.

Синтаксис

int WSCGetProviderPath(
  [in]      LPGUID lpProviderId,
  [out]     WCHAR  *lpszProviderDllPath,
  [in, out] LPINT  lpProviderDllPathLen,
  [out]     LPINT  lpErrno
);

Параметры

[in] lpProviderId

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

[out] lpszProviderDllPath

Указатель на буфер, в который возвращается строка пути dll поставщика. Путь является строкой, заканчивающейся null, и все строки внедренной среды, такие как %SystemRoot%, не были развернуты.

[in, out] lpProviderDllPathLen

Размер (в символах) буфера, на который указывает параметр lpszProviderDllPath .

[out] lpErrno

Указатель на код ошибки в случае сбоя функции.

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

Если ошибка не возникает, WSCGetProviderPath возвращает ноль. В противном случае возвращается SOCKET_ERROR. Конкретный код ошибки доступен в lpErrno.

Код ошибки Значение
WSAEINVAL
 Параметр lpProviderId не указывает допустимый поставщик.
WSAEFAULT
 Параметр lpszProviderDllPath или lpErrno не находится в допустимой части адресного пространства пользователя или слишком мал lpProviderDllPathLen .

Комментарии

Функция WSCGetProviderPath извлекает путь DLL для указанного поставщика. Путь dll может содержать строки внедренной среды, такие как %SystemRoot%, и поэтому его следует развернуть перед использованием с функцией Windows LoadLibrary . Дополнительные сведения см. в разделе LoadLibrary.

Требования

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

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

WSCEnumProtocols

WSCInstallProvider