PROXY_CONFIG

Article
08/28/2006

The PROXY_CONFIG structure tells an application which proxy server to use.

Syntax

typedef struct _PROXY_CONFIG {
  DWORD dwType;
  DWORD dwEnable;
  TCHAR szProxyServer[CMPROXY_PROXYSERVER_MAXSIZE];
  TCHAR szUsername[CMPROXY_USERNAME_MAXSIZE];
  TCHAR szPassword[CMPROXY_PASSWORD_MAXSIZE];
  TCHAR szProxyOverride[CMPROXY_PROXYOVERRIDE_MAXSIZE];
  TCHAR szExtraInfo[CMPROXY_EXTRAINFO_MAXSIZE];
} PROXY_CONFIG;

Members

dwType
The type of proxy server. The potential values of this member are described in the following table.

Value	Description
CONNMGR_FLAG_PROXY_HTTP	HTTP proxy supported.
CONNMGR_FLAG_PROXY_WAP	Wireless Application Protocol (WAP) proxy (gateway) supported.
CONNMGR_FLAG_PROXY_SOCKS4	Microsoft SOCKS version 4.0 proxy supported.
CONNMGR_FLAG_PROXY_SOCKS5	Microsoft SOCKS version 5.0 proxy supported.

dwEnable
Set to 1 by the proxy CSP. If 0, the proxy server configuration exists but the ability to connect to the server is disabled.
szProxyServer
Name and port number of the proxy server. The syntax of this member would be proxy:80, where proxy is the proxy server name and 80 is the value of the port number. The maximum size of this member is specified by CMPROXY_PROXYSERVER_MAXSIZE.
szUsername
User name with which the proxy server connection is made; used only with SOCKS proxy servers.
szPassword
Password associated with the user name specified in szUsername; used only with SOCKS proxy servers. Only trusted applications are allowed to retrieve proxy passwords; if an untrusted application attempts to query the proxy settings for a proxy that has a password associated with it, a result code of E_ACCESSDENIED is returned.
szProxyOverride
Reserved.
szExtraInfo
Reserved; used for WAP proxy servers.

Return Values

None.

Remarks

This structure contains all of the members that an application requires to connect to a proxy server. The proxy connection service provider (CSP) fills in this structure in response to the appropriate ConnMgrProviderMessage function call.

Requirements

Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: connmgr_proxy.h
Library: cellcore.lib