Partager via


w7 APPLICATION

4/8/2010

The w7 APPID in the APPLICATION characteristic is used for bootstrapping a device with an OMA DM account. The following list shows the OMA documents that were referenced:

  • OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C)
  • OMA SyncML DM Tree and Description specification version 1.1.2 (OMA-SyncML-DMTND-V1_1_2-20031202-A)
  • OMA SyncML DM Security specification version 1.1.2 (OMA-SyncML-DMSecurity-V1_1_2-20031209-A)

These specifications are available at this OMA Web site.

The following table shows the features in the APPLICATION characteristic.

Parameter Description

APPLICATION/APPID

The APPID parameter for Application characteristic elements is used in the provisioning XML file to indicate the type of application services and protocols available as described in "Parameters for APPLICATION characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

OMA considers each transport to be an application and requires a corresponding APPLICATION Configuration Service Provider. For information about the supported transports, see APPLICATION Characteristic.

APPLICATION/BACKCOMPATRETRYDISABLED

The BACKCOMPATRETRYDISABLED parameter is used in the APPLICATION characteristic to specify whether to retry resending a package with an older protocol version (for example, 1.1) in the SyncHdr (not including the first time).

> [!NOTE] > This parameter doesn’t contain a value. The existence of this parameter means back compat retry is disabled. If the parameter is missing, it means back compat retry is enabled.

APPLICATION/CONNRETRYFREQ

The CONNRETRYFREQ parameter is used in the APPLICATION characteristic to specify how many retries the DM client performs when there are Connection Manager level or wininet level errors.

APPLICATION/DEFAULTENCODING

The DEFAULTENCODING parameter is used in the APPLICATION characteristic to specify the encoding of the Device Management package. This is a Microsoft custom parameter.

For more information about encoding in OMA DM protocol, see WBXML and OMA DM.

APPLICATION/INIT

The INIT parameter is used in the APPLICATION characteristic to indicate that the management server wants the client to initiate a management session immediately after settings approval.

The INIT parameter forces the device to attempt to connect with the OMA DM server. This is an application-specific parameter.

APPLICATION/INITIALBACKOFFTIME

The INITIALBACKOFFTIME parameter is used in the APPLICATION characteristic to specify the initial wait time in milliseconds when the DM client retries for the first time. The wait time grows exponentially.

APPLICATION/MAXBACKOFFTIME

The MAXBACKOFFTIME parameter is used in the APPLICATION characteristic to specify the maximum number of milliseconds to sleep after package-sending failure.

APPLICATION/NAME

The NAME parameter is used in the APPLICATION characteristic to specify a user readable application identity as described in "Parameters for APPLICATION characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

In Windows Windows Mobile Version 5.0-based devices this parameter is used to specify the user readable name for the management server.

APPLICATION/PROTOVER

The PROTOVER parameter is used in the APPLICATION characteristic to specify the OMA DM Protocol version the server supports. This is a Microsoft custom parameter.

For more information about the PROTOVER parameter, see Device Management Migration from Windows Mobile Version 5.0.

APPLICATION/PROVIDER-ID

The PROVIDER-ID parameter is used in the APPLICATION characteristic to differentiate OMA DM servers. It specifies the server identifier for the Device Management server used in the current management session as described in "Parameters for APPLICATION characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C) and OMA SyncML DM Tree and Description specification version 1.1.2 (OMA-SyncML-DMTND-V1_1_2-20031202-A)

APPLICATION/ROLE

The ROLE parameter is used in the APPLICATION characteristic to specify the role mask that the DM session should run when communicating with the DM server. If this parameter is not present, the DM session is given the role mask that the w7 application document is running with. This is a Microsoft custom parameter.

For more information about role masks, see Security Policy Settings.

APPLICATION/SSLCLIENTCERTSEARCHCRITERIA

The SSLCLIENTCERTSEARCHCRITERIA parameter is used in the APPLICATION characteristic to specify the client cert search criteria. Search by subject attribute and certificate stores is supported. Any other criteria are ignored.

APPLICATION/TO-NAPID

The TO-NAPID parameter is used in the APPLICATION characteristic to specify the Network Access Point (NAP) the client will use to connect to the OMA DM server as described in "Parameters for APPLICATION characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

In Windows Mobile devices, only the first TO-NAPID value will be stored. TO-PROXY is ignored.

APPLICATION/USEHWDEVID

The USEHWDEVID parameter is used in the APPLICATION characteristic to specify the optional use of device hardware identification. It does not have a value. This is a Microsoft custom parameter.

For more information about device hardware identification, see Bootstrapping To Return the Device Hardware ID.

APPLICATION/USENONCERESYNC

The USENONCERESYNC parameter is used in the APPLICATION characteristic to specify the use of nonce resynchronization to attempt recovery from authentication failures. This is a Microsoft custom parameter.

For more information about nonce resynchronization, see OMA DM MD5 Authentication Nonce.

The following table shows the features in the APPADDR characteristic.

Parameter Description

APPADDR/ADDR

The ADDR parameter is used in the APPADDR characteristic to provide the address of the OMA DM server as described in "Parameters for APPADDR characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

APPADDR/ADDRTYPE

The ADDRTYPE parameter is used the APPADDR characteristic to indicate the format of the ADDR parameter as described in "Parameters for APPADDR characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

The following table shows the features in the APPAUTH characteristic.

Parameter Description

APPAUTH/AAUTHDATA

The AAUTHDATA parameter is used in the APPAUTH characteristic to provide additional parameters used to authenticate the user as described in "Parameters for APPAUTH characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

When this parameter is used in Windows Mobile devices to convey the nonce for digest authentication type, the nonce must be encoded as b64 in the XML provisioning file.

APPAUTH/AAUTHLEVEL

The AAUTHLEVEL parameter is used in the APPAUTH characteristic to indicate whether credentials are for server authentication or client authentication as described in "Parameters for APPAUTH characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

APPAUTH/AAUTHSECRET

The AAUTHSECRET parameter is used in the APPAUTH characteristic to provide the authentication secret used to authenticate the user as described in "Parameters for APPAUTH characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

APPAUTH/AAUTHTYPE

The AAUTHTYPE parameter is used in the APPAUTH characteristic to provide information about the authentication type as described in "Parameters for APPAUTH characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

Windows Mobile devices support BASIC and DIGEST for client authentication. DIGEST is supported for server authentication

The following table shows the features in the PORT characteristic.

Parameter Description

PORT/PORTNBR

The PORTNBR parameter is used in the PORT characteristic to identify the port number to connect to as described in "Parameters for PORT characteristics" in the OMA Provisioning Content specification version 1.1 (OMA-WAP-ProvCont-v1_1-20050428-C).

See Also

Reference

APPLICATION Configuration Service Provider

Concepts

w7 APPLICATION Configuration Service Provider

Other Resources

APPLICATION Characteristic