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

Статья
08/28/2023

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

Синтаксис

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

Параметры

[in] lpProviderId

Локальный уникальный идентификатор поставщика. Это должно быть значение, полученное с помощью WSCEnumProtocols.

[out] lpszProviderDllPath

Указатель на буфер, содержащий строку, определяющую путь к библиотеке DLL поставщика. Этот путь является строкой со значением NULL, и все строки внедренной среды (например, %SystemRoot%) не были развернуты.

[in, out] lpProviderDllPathLen

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

[out] lpErrno

Указатель на код ошибки.

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

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

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

Функция WPUGetProviderPath извлекает путь DLL для указанного поставщика. Путь DLL завершается null и может содержать строки внедренной среды (например, %SystemRoot%). Таким образом, строка должна быть расширена перед использованием с LoadLibrary. Дополнительные сведения см. в разделе LoadLibrary.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ws2spi.h

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

WSCEnumProtocols

WSCInstallProvider

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