Función WSCGetProviderPath32 (ws2spi.h)

  • Artículo

La función WSCGetProviderPath32 recupera la ruta de acceso DLL del proveedor de 32 bits especificado.

Nota Esta llamada es una versión estricta de 32 bits de WSCGetProviderPath para su uso en plataformas de 64 bits. Se proporciona para permitir que los procesos de 64 bits accedan a los catálogos de 32 bits.

 

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
WSAEINVAL
 El parámetro lpProviderId no especifica un proveedor válido.
WSAEFAULT
 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

Consulte también

WSCEnumProtocols32

WSCInstallProvider64_32