Share via

CM_ProxyEntries Configuration Service Provider

  • Article

The CM_ProxyEntries Configuration Service Provider configures proxy connections on the device.

Note Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information, see Security Roles.

The nocharacteristic tag will work on the top two levels to delete all, or specific, entries.

The following table shows the default settings.

Permissions Read/Write
Roles allowed to query and update setting Manager

AuthenticatedUser

Characteristics

  • <entryname>
    Specifies settings for the <entryname> parameter, which sets the name of the connection. Settings under this characteristic specify parameters for this proxy connection.

Parms

  • Enable
    This parm can be used in the <entryname> characteristic to enable or disable a connection entry without removing it from the system. Permitted values are 0 for OFF or 1 for ON.

    The following table shows the default settings.

    Permissions Read/Write
    Data type Boolean
    Label Enable
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Extrainfo
    Used in the <entryname> characteristic to store additional information that does not fit appropriately into any of the other proxy fields. Typically, this parameter is used to store additional WAP proxy information.

  • DestId
    Used in the <entryname> characteristic as a GUID that represents the unique ID of the network to which this entry connects. See the Connmgr.h header for predefined GUID values IID_DestNet*.

    Typically, a proxy connection connects from a private network to the Internet, so the value of DestId would be that of IID_DestNetInternet, which is "{436EF144-B4FB-4863-A041-8F905A62C572}."

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    Label Connects to
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Override
    Reserved for future use.

  • Password
    Used in the <entryname> characteristic to specify the password of the proxy entry, if one exists. Passwords are only required for WAP and SOCKS proxies and are not used for HTTP proxies. Queries of this field return a string composed of asterisks (*).

    When setting the password, passing in the same string causes the new password to be ignored and does not change the existing password.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Password:
    Semantic type alphanumeric-password
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Proxy
    Used in the <entryname> characteristic to specify the name and port number of the proxy server. For HTTP proxies, the value of this parameter uses the <name>:<port> format, for example, myproxy:80.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Proxy (name:port):
    Semantic type url
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • SrcId
    Used in the <entryname> characteristic as a GUID that represents the unique ID of the network from which this entry connects. See the Connmgr.h header for predefined GUID values IID_DestNet*.

    The following table shows the default settings.

    Permissions read/write
    Data type string
    Label Connects from:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Type
    Used in the <entryname> characteristic to specify the type of the proxy entry. Possible values are:

    • 0 for null proxies
    • 1 for HTTP proxies
    • 2 for WAP proxies
    • 4 for SOCKS4 proxies
    • 5 for SOCKS5 proxies

    The value of 0 is reserved to denote a null proxy. This value can be used to allow Connection Manager to treat one network as a superset of another network by creating a null proxy from one network to the other.

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • UserName
    If a proxy entry exists, this parm is used in the <entryname> characteristic to specify the username of the proxy entry.

Elements

Elements Available
parm-query Yes
noparm No
nocharacteristic Yes

Top-level: Yes
characteristic-query Yes

Recursive query:Yes

Top level query: Yes

For information about specific elements, see MSPROV DTD Elements.

See Also

Configuration Service Provider Reference for Windows Mobile Devices | CM_ProxyEntries Configuration Service Provider Examples

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.