Provisioning XML Document for Uninstall Configuration Service Provider (Compact 2013)

  • Article

3/26/2014

Configuration Manager uses this XML document to uninstall applications from a Windows Embedded Compact powered device.

Syntax

<wap-provisioningdoc>
    <characteristic type="UnInstall">
        <characteristic type="<Application>">
          <parm name="uninstall" value="1" /> 
          <parm-query name="<ParmName>" />
        </characteristic>
        <characteristic-query type="<Application>" />
    </characteristic>
</wap-provisioningdoc>

Elements

Element name

Description

Attributes

characteristic

Groups settings for a configuration service provider.
type

The type of group. It can be one of the following:

ValueDescription
UninstallIndicates the root characteristic element for the Uninstall configuration service provider.
<Application_to_uninstall>Name of the application to uninstall.

parm

Metadata that describes a device setting.
name

The name of the device setting to configure. Set to "uninstall" to uninstall the application.

When set to "uninstall," the corresponding value attribute must be set to 1 to uninstall the application specified in the type attribute of the parent characteristic element.

value

See description in name attribute for possible values.

characteristic-query

Use this element to query the setting values specified by the characteristic in the type attribute.
type

Any supported type attribute that is listed above.

parm-query

Specifies a request for the current value of a setting.
name

Any supported name attribute that is listed above.

value

In query results, the "uninstall" value always returns 0 (zero).

Remarks

A provisioning document that uninstalls an application must contain XML for only the Uninstall configuration service provider.

To uninstall an application from the device, you can write a provisioning XML file that you customize for the Uninstall configuration service provider. However, the Uninstall configuration service provider supports only a subset of elements and its own attribute values for the characteristic and parm elements.

For more information about elements, see Provisioning XML Document.

Example

The following code example uninstalls an application named "Application 2."

Important

For readability, the following code example does not contain security checking or error handling. Do not use the following code in a production environment.

<wap-provisioningdoc>
    <characteristic type="UnInstall">
        <characteristic type="Application 2">
          <parm name="uninstall" value="1" /> 
        </characteristic>
    </characteristic>
</wap-provisioningdoc>

See Also

Reference

Configuration Service Provider Reference
IConfigManager