Función WSCGetProviderPath (ws2spi.h)

  • Artículo

La función WSCGetProviderPath recupera la ruta de acceso dll del proveedor especificado.

Sintaxis

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

Parámetros

[in] lpProviderId

Puntero a un identificador único global (GUID) para el proveedor. Este valor se obtiene mediante WSCEnumProtocols.

[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, en caracteres, del búfer al que apunta el parámetro lpszProviderDllPath .

[out] lpErrno

Puntero al código de error si se produce un error en la función.

Valor devuelto

Si no se produce ningún error, WSCGetProviderPath 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.

Comentarios

La función WSCGetProviderPath 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

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ws2spi.h
Library Ws2_32.lib
Archivo DLL Ws2_32.dll

Consulte también

WSCEnumProtocols

WSCInstallProvider