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

Статья
03/13/2024

Функция 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

Share via