Share via


PROXY_CONFIG

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

Pocket PC: Windows Mobile 2000 and later
OS Versions: Windows CE 3.0 and later
Header: connmgr_proxy.h
Library: cellcore.lib

See Also

Connection Manager

Connection Manager API Structures

ConnMgrProviderMessage

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.