PXLOGICAL Configuration Service Provider

The PXLOGICAL Configuration Service Provider adds, removes, and modifies WAP logical and physical proxies by using WAP or the standard Windows Mobile-based device techniques. For more information, see the Update Standard WAP Connectivity Parameters.

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.

Note The PXLOGICAL and PXPHYSICAL mwid attribute is a Microsoft provisioning XML attribute. The mwid attribute is optional when adding a NAP or a proxy. It is required when updating and deleting existing NAPs and proxies and must have its value set to 1.

The following table shows the default settings for all parms in this Configuration Service Provider.

Characteristics

• PORT
  This characteristic defines the binding between a port number and one or more protocols or services. This Configuration Service Provider can accept a maximum of two ports per physical proxy. A query of this characteristic returns information relating only to the first port.
• PXPHYSICAL
  This characteristic groups files for a physical proxy. One PXLOGICAL characteristic can contain multiple PXPHYSICAL characteristics.

Parms

• BASAUTH-ID
  This parm can be used in all PXLOGICAL characteristics. It contains the user ID of the start page. Query of this parm is not supported.

• BASAUTH-PW
  This parm can be used in all PXLOGICAL characteristics. It contains the user password of the start page. Query of this parm is not supported.

• DOMAIN
  This parm is used in the PXLOGICAL and PXPHYSICAL characteristics. A query of this parm returns a semicolon delimited string of all domains.

• NAME
  This parm can be used in all PXLOGICAL characteristics. It contains the name of the proxy.

  Note  The NAME parm in PXLOGICAL is displayed in one line to the user; the length of this parm should be short for readability.

• PHYSICAL-PROXY-ID
  This parm is used in the PXPHYSICAL characteristic to identify the physical proxy.

  Note  The PHYSICAL-PROXY-ID parm is displayed in one line to the user; the length of this parm should be short for readability.

• PORTNBR
  This parm is used in the PXLOGICAL\PORT and PXPHYSICAL\PORT characteristics to identify the port number associated with some services on this proxy.

• PROXY-ID
  This parm can be used in all PXLOGICAL characteristics. It contains the unique identification of the logical proxy.

• PUSHENABLED
  This parm is used in the PXLOGICAL and PXPHYSICAL characteristics to determine whether or not push operations are enabled. If the parm is used in PXLOGICAL, it applies to all of the PXPHYSICAL characteristics embedded in the PXLOGICAL characteristic. A value of zero (0) indicates that the proxy does not support push operations. A value of 1 indicates that the proxy supports push operations.

• PXADDR
  This parm is used in the PXPHYSICAL characteristic to identify the address of the physical proxy.

• PXADDRTYPE
  This parm is used in the PXPHYSICAL characteristic to determine the address type for PXADDR. Only E164, IPv4, and IPv6 are supported.

  Note  Windows Mobile 2003 provides support for IPv6 only in IPv4/IPv6 mixed-mode environments.

• SERVICE
  This parm is used in the PXLOGICAL\PORT and PXPHYSICAL\PORT characteristics. A query of this parm returns a semicolon-delimited string of services for only the first port. Supported services on the Windows Mobile Web browser (Microsoft Pocket Internet Explorer) include CO-WSP and CO-SEC-WSP. Windows Mobile also supports accepting WAP push connectionless sessions over an Short Message Service (SMS) bearer for WAP push messages.

• STARTPAGE
  This parm can be used in all PXLOGICAL characteristics. It identifies the start Web page for the proxy.

  Note  If this parm is present, a Pocket Internet Explorer browser favorite will be generated whose name corresponds to the PXLOGICAL NAME parm value (or STARTPAGE value if NAME is not present), and whose URL corresponds to the STARTPAGE parm value. Also, if the URL's scheme is "http" or "https," it will be converted to "wsp" or "wsps," respectively.

• TO-NAPID
  This parm is used in the PXPHYSICAL characteristic to identify the network access point associated with this physical proxy. Only one per proxy is supported.

• TRUST
  This parm can be used in all PXLOGICAL characteristics to define whether or not the physical proxies in this logical proxy are trusted.

  The following table shows the default settings.

Feature Availability

The parm-query and characteristic-query features are not supported for all PXPHYSICAL proxy parms for all PXADDR types. Only those parms stored under PGList in the registry can be queried for a PXPHYSICAL proxy with PXADDR type E164. All parms can be queried when the PXPHYSICAL proxy PXADDRType is IPv4 or IPv6. For example, if a mobile operator queries the TO-NAPID parm of a PXPHYSICAL proxy and the PXADDR Type is E164, a noparm is returned.

Note These features are available only for the device technique.

For information about specific elements, see MSPROV DTD Elements.

See Also

Configuration Service Provider Reference for Windows Mobile Devices| PXLOGICAL Configuration Service Provider Examples| WAP Logical Proxy: PXLOGICAL

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.