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

3/12/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: Value Description 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