Share via


IWebProxy interface

Contains the HTTP proxy settings.

Important  This interface is not supported on Windows 10 and Windows Server 2016. See the remarks for more details.

 

Members

The IWebProxy interface inherits from the IDispatch interface. IWebProxy also has these types of members:

  • Methods
  • Properties

Methods

The IWebProxy interface has these methods.

Method Description
PromptForCredentials

Prompts the user for the password to use for proxy authentication.

PromptForCredentialsFromHwnd

Prompts the user for the password to use for proxy authentication.

SetPassword

Sets the password to submit to the proxy server for authentication.

 

Properties

The IWebProxy interface has these properties.

Property Access type Description

Address

Read/write

Gets and sets the address and the decimal port number of the proxy server.

AutoDetect

Read/write

Gets and sets a Boolean value that indicates whether IWebProxy automatically detects proxy settings.

BypassList

Read/write

Gets and sets a collection of addresses that do not use the proxy server.

BypassProxyOnLocal

Read/write

Gets and sets a Boolean value that indicates whether local addresses bypass the proxy server.

ReadOnly

Read-only

Gets a Boolean value that indicates whether the WebProxy object is read-only.

UserName

Read/write

Gets and sets the user name to submit to the proxy server for authentication.

 

Remarks

You can create an instance of this interface by using the WebProxy coclass. Use the Microsoft.Update.WebProxy program identifier to create the object.

Important  This interface is not supported on Windows 10 and Windows Server 2016. To configure proxy settings on these operating systems (including proxy settings for Windows Update Agent), use the Proxy page of the Network & Internet section in Settings. You can optionally use a proxy auto-config script to apply settings. If you configure proxy settings, be sure to allow access to the domains used by Windows Update listed in this article.

 

Requirements

Minimum supported client

Windows XP, Windows 2000 Professional with SP3 [desktop apps only]

Minimum supported server

Windows Server 2003, Windows 2000 Server with SP3 [desktop apps only]

Header

Wuapi.h

IDL

Wuapi.idl

Library

Wuguid.lib

DLL

Wuapi.dll

IID

IID_IWebProxy is defined as 174C81FE-AECD-4DAE-B8A0-2C6318DD86A8