Share via

PROXY_CONFIG (Connection Manager) (Compact 2013)

  • Article

3/26/2014

This structure directs an application to use a particular proxy.

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 is 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. For information on CMPROXY_PROXYSERVER_MAXSIZE, see Connection Manager Proxy Constants.

  • szUsername
    Indicates the user name by which the proxy server connection is made; used only with SOCKS proxy servers.

    For information on CMPROXY_USERNAME_MAXSIZE, see Connection Manager Proxy Constants.

  • 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.

    For information on CMPROXY_PASSWORD_MAXSIZE, see Connection Manager Proxy Constants.

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

See Also

Reference

Connection Manager Proxy Structures
Connection Manager Proxy Constants