URLMkSetSessionOption

Sets options for current Internet session.

WINOLEAPI URLMkSetSessionOption(
  DWORD dwOption,        // Session option to be set
  LPVOID pBuffer,        // Buffer containing new settings
  DWORD dwBufferLength,  // Length of pBuffer
  DWORD dwReserved       // Reserved for future use
);
 

Parameters

dwOption

[in] The session option to be set. Currently, URL Monikers support only the value INTERNET_OPTION_PROXY, which allows a client to overwrite the current proxy settings. Other values may be added later.

pBuffer

[in] A buffer containing new session settings

dwBufferLength

[in] The size of pBuffer.

dwReserved

[in] Reserved for future use. Must be set to zero.

Return Values

S_OK

Options were successfully set.

E_INVALIDARG

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.

Note  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.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in urlmon.h.