PROXY_CONFIG

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This 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
    Indicates the type of proxy server. One of the Connection Manager proxy flag constants.
  • dwEnable
    Set to 1 by the proxy Configuration Service Provider. If this value is 0, the proxy server configuration exists, but the ability to connect to the proxy server is disabled.
  • szProxyServer
    Indicates 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
    Indicates the user name by 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 privileged applications are able to retrieve proxy passwords; if a normal 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 Wireless Access Protocol (WAP) proxy servers.

Remarks

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

Requirements

Header connmgr_proxy.h
Windows Embedded CE Windows CE .NET 4.2 and later, Windows Embedded NavReady 2009
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ConnMgrProviderMessage
Connection Manager Proxy Flag Constants
Connection Manager Structures