Windows Installer Provider::Uninstall

Uninstalls a Microsoft® Windows® Installer package file (.msi). Used by Microsoft® Provisioning Framework (MPF).

XML Input Schema

The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.

<executeData>1..1
  <userName>1..1</userName>
  <userPassword>1..1</userPassword>
  <installedServer>1..1</installedServer>
  <msiInstallHelper>1..1</msiInstallHelper>
  <msiPackage path="..">1..1
	<property name=".." value="..">0..unbounded</property>
  </msiPackage>
</executeData>

XML Output Schema

Uninstall does not return data.

Elements and Attributes

The following table describes the XML elements and attributes. Unless otherwise indicated, the data type is string.

Element Description, relationships, and attributes
executeData Description:
 Encapsulates the procedure's input data.

Children:
 installedServer (minOccurs="1" maxOccurs="1")
msiInstallHelper (minOccurs="1" maxOccurs="1")
msiPackage (minOccurs="1" maxOccurs="1")
property (minOccurs="0" maxOccurs="*")
userName (minOccurs="1" maxOccurs="1")
userPassword (minOccurs="1" maxOccurs="1")
installedServer Description:
 Target computer for the uninstall.

Maximum Length:
 1,024

Parent:
executeData

msiInstallHelper Description:
 Path of the MPF InstallHelper agent that communicates with the Windows Installer on the target computer. Found in the Providers\InstallHelper\installhelper.msi file (usually located in Program Files\Microsoft Provisioning).

Maximum Length:
 1,024

Parent:
executeData

msiPackage Description:
 Windows Installer package file (.msi) to uninstall.

Maximum Length:
 1,024

Parent:
executeData

Attribute:

path Required. Windows Installer package file (.msi) to uninstall.
property Description:
 Install parameters for the .msi file.

Parent:
executeData

Attribute:

name Required. Name of the uninstall property. Maximum length 1,024.
value Required. Value for the uninstall property. Maximum length 1,024.
userName Description:
 User security context to impersonate for the uninstall.

Maximum Length:
 256

Parent:
executeData

userPassword Description:
 Password for the user to impersonate for the uninstall.

Maximum Length:
 256

Parent:
executeData

Remarks

The following example shows a sample Windows Installer uninstall request.

<request>
  <data>
	<userName>bob1</userName>
	<userPassword>abc</userPassword>
	<installedServer>machine4</installedServer>
	<msiInstallHelper>c:\installhelper.msi</msiInstallHelper>
	<msiPackage path="\\machine4\c$\goodbye.msi">
	<property name="prop1" value="value1" />
	<property name="prop2" value="value2" />
	<property name="prop3" value="value3" />
	</msiPackage>
  </data>
  <procedure> 
	<execute procedure="Install" namespace="Windows Installer Provider">
	<before source="data" destination="executeData" mode="merge" />
	</execute>
  </procedure> 
</request>

See Also

Install, Windows Installer Provider

Up Top of Page
© 1999-2002 Microsoft Corporation. All rights reserved.