Platform SDK: Windows Sockets

WSCGetProviderPath

The WSCGetProviderPath function retrieves the DLL path for the specified provider.

int WSCGetProviderPath(
  LPGUID     lpProviderId,         
  LPWSTR     lpszProviderDllPath,  
  LPINT      lpProviderDllPathLen,  
  LPINT      lpErrno                
);

Parameters

lpProviderId: [in] Locally unique identifier of the provider. This value is obtained by using WSCEnumProtocols.
lpszProviderDllPath: [out] Pointer to a buffer into which the provider DLL's path string is returned. The path is a null-terminated string and any embedded environment strings, such as %SystemRoot%, have not been expanded.
lpProviderDllPathLen: [in/out] Size of the buffer pointed to by the lpszProviderDllPath parameter.
lpErrno: [out] Pointer to the error code.

Return Values

If no error occurs, WSCGetProviderPath returns zero. Otherwise, it returns SOCKET_ERROR. The specific error code is available in lpErrno.

Remarks

The WSCGetProviderPath function retrieves the DLL path for the specified provider. The DLL path can contain embedded environment strings, such as %SystemRoot%, and thus should be expanded prior to being used with the Win32 LoadLibrary function. For more information, see LoadLibrary.

Error Codes

Error code	Meaning
WSAEINVAL	The lpProviderId parameter does not specify a valid provider.
WSAEFAULT	The lpszProviderDllPath or lpErrno parameter is not in a valid part of the user address space, or lpProviderDllPathLen is too small.

Requirements