WSCGetProviderPath32 function

The WSCGetProviderPath32 function retrieves the DLL path for the specified 32-bit provider.

Note  This call is a strictly 32-bit version of WSCGetProviderPath for use on 64-bit platforms. It is provided to allow 64-bit processes to access the 32-bit catalogs.


int WSPAPI WSCGetProviderPath32(
  _In_    LPGUID lpProviderId,
  _Out_   LPWSTR lpszProviderDllPath,
  _Inout_ LPINT  lpProviderDllPathLen,
  _Out_   LPINT  lpErrno


lpProviderId [in]

Locally unique identifier of the provider. This value is obtained by using WSCEnumProtocols32.

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, in characters.

lpErrno [out]

Pointer to the error code.

Return value

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

Error codeMeaning

The lpProviderId parameter does not specify a valid provider.


The lpszProviderDllPath or lpErrno parameter is not in a valid part of the user address space, or lpProviderDllPathLen is too small.



WSCGetProviderPath32 is a strictly 32-bit version of WSCGetProviderPath. On a 64-bit computer, all calls not specifically 32-bit (for example, all functions that do not end in "32") operate on the native 64-bit catalog. Processes that execute on a 64-bit computer must use the specific 32-bit function calls to operate on a strictly 32-bit catalog and preserve compatibility. The definitions and semantics of the specific 32-bit calls are the same as their native counterparts.

The WSCGetProviderPath32 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 Windows LoadLibrary function. For more information, see LoadLibrary.


Minimum supported client

Windows Vista, Windows XP Professional x64 Edition [desktop apps only]

Minimum supported server

Windows Server 2008, Windows Server 2003 x64 Edition [desktop apps only]







See also