Edit

Share via

WINHTTP_PROXY_INFO structure (winhttp.h)

  • Article

The WINHTTP_PROXY_INFO structure contains the session or default proxy configuration.

Syntax

typedef struct _WINHTTP_PROXY_INFO {
  DWORD  dwAccessType;
  LPWSTR lpszProxy;
  LPWSTR lpszProxyBypass;
} WINHTTP_PROXY_INFO, *LPWINHTTP_PROXY_INFO, *PWINHTTP_PROXY_INFO;

Members

dwAccessType

Unsigned long integer value that contains the access type. This can be one of the following values:

Value Meaning
WINHTTP_ACCESS_TYPE_NO_PROXY
 Internet accessed through a direct connection.
WINHTTP_ACCESS_TYPE_DEFAULT_PROXY
 Applies only when setting proxy information.
WINHTTP_ACCESS_TYPE_NAMED_PROXY
 Internet accessed using a proxy.

lpszProxy

Pointer to a string value that contains the proxy server list.

lpszProxyBypass

Pointer to a string value that contains the proxy bypass list.

Remarks

This structure is used with WinHttpSetOption and WinHttpQueryOption to get or set the proxy configuration for the current session by specifying the WINHTTP_OPTION_PROXY flag.

This structure is used with WinHttpSetDefaultProxyConfiguration and WinHttpGetDefaultProxyConfiguration to get or set the default proxy configuration in the registry.

The proxy server list contains one or more of the following strings separated by semicolons or whitespace.

([<scheme>=][<scheme>"://"]<server>[":"<port>])

The proxy bypass list contains one or more server names separated by semicolons or whitespace. The proxy bypass list can also contain the string "<local>" to indicate that all local intranet sites are bypassed. Local intranet sites are considered to be all servers that do not contain a period in their name.

Note  For Windows XP and Windows 2000, see the Run-Time Requirements section of the WinHttp start page.
 

Requirements

Requirement Value
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 winhttp.h
Redistributable WinHTTP 5.0 and Internet Explorer 5.01 or later on Windows XP and Windows 2000.

See also

WinHTTP Versions