InternetSetOption Function

---

Sets an Internet option.

Syntax

BOOL InternetSetOption(
    IN HINTERNET hInternet,
    IN DWORD dwOption,
    IN LPVOID lpBuffer,
    IN DWORD dwBufferLength
);

The actual syntax of this function varies between its ANSI and Unicode implementations. For more information, see Win32 Internet Functions Syntax.

Parameters

hInternet

HINTERNET handle on which to set information.

dwOption

Unsigned long integer value that contains the Internet option to set. This can be one of the Option Flags values.

lpBuffer

Address of a buffer that contains the option setting.

dwBufferLength

Unsigned long integer value that contains the length of the lpBuffer buffer in TCHAR.

Return Value

Returns TRUE if successful, or FALSE otherwise. To get a specific error message, call GetLastError.

Remarks

GetLastError will return the error ERROR_INVALID_PARAMETER if an option flag that cannot be set is specified.

Function Information

Windows NT	Use version 4.0. Implemented as ANSI and Unicode functions.
Windows	Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header	Wininet.h
Import library	Wininet.lib
Minimum availability	Internet Explorer 3.0 (ANSI only), 5 (ANSI and Unicode)

Windows CE

Windows CE	Use version 2.12 and later. Implemented as ANSI and Unicode functions.
Minimum availability	Internet Explorer 4.0

See Also

Microsoft Win32 Internet Functions Overview, Common Functions, Microsoft Win32 Internet Functions Reference, General Win32 Internet Functions, FtpGetFile, FtpPutFile, InternetConnect, InternetOpen, InternetQueryOption