UrlMkSetSessionOption

Sets options for the current Internet session.

Syntax

HRESULT UrlMkSetSessionOption(
    [in] DWORD dwOption,
    [in] LPVOID pBuffer,
    [in] DWORD dwBufferLength,
    [in] DWORD dwReserved
);

Parameters

dwOption
Session option to be set. Can be one of the following values:

INTERNET_OPTION_PROXY Sets the proxy settings. pBuffer must contain an INTERNET_PROXY_INFO structure. INTERNET_OPTION_PROXY and INTERNET_PROXY_INFO are defined in the Wininet.h file. For more information, see the Microsoft Win32 Internet Functions Reference.

INTERNET_OPTION_REFRESH Sets the value that determines if the proxy information can be reread from the registry. The value TRUE indicates that the proxy information can be reread from the registry. For more information on this value, see the Microsoft Win32 Internet Functions Reference.

pBuffer
Buffer containing the new session settings.

dwBufferLength
Size of pBuffer.

dwReserved
Reserved for future use. Must be set to zero.

Return Value

Returns S_OK if options were successfully set, or E_INVALIDARG if one of the parameters is invalid.

Remarks

This function maps directly to the Windows® Internet function InternetSetOption, although UrlMkSetSessionOption allows only global options to be set.
To use this function, the client code must include the Wininet.h header file, which declares values for the dwOption parameter and structures for the pBuffer parameter.

INTERNET_OPTION_PROXY	Sets the proxy settings. pBuffer must contain an INTERNET_PROXY_INFO structure. INTERNET_OPTION_PROXY and INTERNET_PROXY_INFO are defined in the Wininet.h file. For more information, see the Microsoft Win32 Internet Functions Reference.
INTERNET_OPTION_REFRESH	Sets the value that determines if the proxy information can be reread from the registry. The value TRUE indicates that the proxy information can be reread from the registry. For more information on this value, see the Microsoft Win32 Internet Functions Reference.