UrlMkGetSessionOption Function

---

Sets options for the current Internet session.

Syntax

HRESULT UrlMkGetSessionOption(
    DWORD dwOption,
    LPVOID pBuffer,
    DWORD dwBufferLength,
    DWORD *pdwBufferLength,
    DWORD dwReserved
);

Parameters

dwOption

[in] Unsigned long integer value containing the session options to be retrieved. This can be one of the following values:

URLMON_OPTION_URL_ENCODING	Retrieve Internet Explorer's default encoding policy. This value was introduced in Internet Explorer 5.
URLMON_OPTION_USERAGENT	Retrieve the current user agent string.

pBuffer

[in] Address of the buffer containing the new session settings.

dwBufferLength

[in] Unsigned long integer value containing the size of pBuffer.

pdwBufferLength

[out] Address of an unsigned long integer value containing the size of the data stored in the buffer or the size required to store the data if the buffer size was insufficient.

dwReserved

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

Return Value

Returns one of the following values:

S_OK	The option was successfully set.
E_INVALIDARG	The option is not supported or there is an invalid parameter.
E_FAIL	The option could not be set.

Function Information

Windows NT	Use version 4.0. Implemented as an ANSI function.
Windows	Use Windows 95 and later. Implemented as an ANSI function.
Header	Urlmon.h
Import Library	Urlmon.lib
Minimum availability	Internet Explorer 3.0