UrlMkSetSessionOption


		Contents Index Topic Contents
	Previous Topic: UrlMkGetSessionOption Next Topic: URLOpenBlockingStream

UrlMkSetSessionOption
HRESULT UrlMkSetSessionOption(
    [in] DWORD dwOption,
    [in] LPVOID pBuffer,
    [in] DWORD dwBufferLength,
    [in] DWORD dwReserved
);
Sets options for the current Internet session.
Returns S_OK if options were successfully set, or E_INVALIDARG if one of the parameters is invalid.

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 Function 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 Function Reference.

pBuffer
Buffer containing the new session settings.
dwBufferLength
Size of pBuffer.
dwReserved
Reserved for future use. Must be set to zero.

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.

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

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 Function 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 Function Reference.