WSCGetProviderPath32 function (ws2spi.h)

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

Syntax

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

Parameters

[in] lpProviderId

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

[out] lpszProviderDllPath

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.

[in, out] lpProviderDllPathLen

Size of the buffer pointed to by the lpszProviderDllPath parameter, in characters.

[out] lpErrno

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.

Remarks

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.

Requirements

See also

WSCEnumProtocols32

WSCInstallProvider64_32