Función WSCGetProviderPath32 (ws2spi.h)
La función WSCGetProviderPath32 recupera la ruta de acceso DLL del proveedor de 32 bits especificado.
Sintaxis
int WSCGetProviderPath32(
[in] LPGUID lpProviderId,
[out] WCHAR *lpszProviderDllPath,
[in, out] LPINT lpProviderDllPathLen,
[out] LPINT lpErrno
);
Parámetros
[in] lpProviderId
Identificador único local del proveedor. Este valor se obtiene mediante WSCEnumProtocols32.
[out] lpszProviderDllPath
Puntero a un búfer en el que se devuelve la cadena de ruta de acceso del archivo DLL del proveedor. La ruta de acceso es una cadena terminada en null y las cadenas de entorno incrustadas, como %SystemRoot%, no se han expandido.
[in, out] lpProviderDllPathLen
Tamaño del búfer al que apunta el parámetro lpszProviderDllPath , en caracteres.
[out] lpErrno
Puntero al código de error.
Valor devuelto
Si no se produce ningún error, WSCGetProviderPath32 devuelve cero. De lo contrario, devuelve SOCKET_ERROR. El código de error específico está disponible en lpErrno.
| Código de error | Significado |
|---|---|
| El parámetro lpProviderId no especifica un proveedor válido. | |
| El parámetro lpszProviderDllPath o lpErrno no está en una parte válida del espacio de direcciones del usuario, o lpProviderDllPathLen es demasiado pequeño. |
Observaciones
WSCGetProviderPath32 es una versión estricta de 32 bits de WSCGetProviderPath. En un equipo de 64 bits, todas las llamadas no son específicamente de 32 bits (por ejemplo, todas las funciones que no terminan en "32") funcionan en el catálogo nativo de 64 bits. Los procesos que se ejecutan en un equipo de 64 bits deben usar las llamadas de función específicas de 32 bits para funcionar en un catálogo estrictamente de 32 bits y conservar la compatibilidad. Las definiciones y la semántica de las llamadas específicas de 32 bits son las mismas que sus equivalentes nativos.
La función WSCGetProviderPath32 recupera la ruta de acceso DLL del proveedor especificado. La ruta de acceso DLL puede contener cadenas de entorno incrustadas, como %SystemRoot%, y, por tanto, debe expandirse antes de usarse con la función LoadLibrary de Windows. Para obtener más información, consulte LoadLibrary.
Requisitos
| Cliente mínimo compatible | Windows Vista, Windows XP Professional x64 Edition [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008, Windows Server 2003 x64 Edition [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ws2spi.h |
| Library | Ws2_32.lib |
| Archivo DLL | Ws2_32.dll |