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

  • Статья

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

Примечание Этот вызов является строго 32-разрядной версией WSCGetProviderPath для использования на 64-разрядных платформах. Он предоставляется для предоставления 64-разрядным процессам доступа к 32-разрядным каталогам.

 

Синтаксис

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

Параметры

[in] lpProviderId

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

[out] lpszProviderDllPath

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

[in, out] lpProviderDllPathLen

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

[out] lpErrno

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

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

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

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

Комментарии

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

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

Требования

   
Минимальная версия клиента Windows Vista, Windows XP Professional x64 Edition [только классические приложения]
Минимальная версия сервера Windows Server 2008, Windows Server 2003 x64 Edition [только классические приложения]
Целевая платформа Windows
Header ws2spi.h
Библиотека Ws2_32.lib
DLL Ws2_32.dll

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

WSCEnumProtocols32

WSCInstallProvider64_32