Registry Provider::DeleteRegValue

Deletes a named value for a specific registry item. Used by Microsoft® Provisioning Framework (MPF).

DeleteRegValue is a wrapper for the Microsoft® Win32® API function RegDeleteValue.

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
  <regValue>1..1
	<machine>1..1
	<name>1..1</name>
	</machine>
	<rootkey>1..1
	<name>1..1</name>
	</rootkey> 
	<subkey>1..1
	<name>1..1</name>
	</subkey>
	<item>1..1
	<name>1..1</name>
	</item>
  </regValue>
</executeData>

XML Output Schema

DeleteRegValue 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:
 regValue (minOccurs="1" maxOccurs="1")
item Description:
 Item for the value to delete. The following sample code illustrates the use of item. 
<item>
  <name>CompletionChar</name>
</item>

Parent:
regValue

Child:
 name (minOccurs="1" maxOccurs="1")
machine Description:
 Machine for the value to delete. The following sample code illustrates the use of machine. 
<machine>
  <name>BOB1</name>
</machine>

Parent:
regValue

Child:
 name (minOccurs="1" maxOccurs="1")
name Description:
 Name of the item, machine, root key, or subkey for the value to delete.

Parents:
machine, rootkey, subkey

regValue Description:
 Encapsulates information about the registry value to delete. The following sample code illustrates the use of regValue. 
<regValue>
  <machine>
	<name>BOB1</name>
  </machine>
  <rootkey>
	<name>HKEY_LOCAL_MACHINE</name>
  </rootkey>
  <subkey>
	<name>SOFTWARE\Microsoft\Active Setup</name>
  </subkey>
  <item>
	<name>CompletionChar</name>
  </item>
</regValue>

Parent:
executeData

Children:
 item (minOccurs="1" maxOccurs="1")
machine (minOccurs="1" maxOccurs="1")
rootkey (minOccurs="1" maxOccurs="1")
subkey (minOccurs="1" maxOccurs="1")
rootkey Description:
 Root key for the value to delete. The following sample code illustrates the use of rootkey. 
<rootkey>
  <name>HKEY_LOCAL_MACHINE</name>
</rootkey>

Parent:
regKey

Child:
 name (minOccurs="1" maxOccurs="1")
subkey Description:
 Subkey for the value to delete. The following sample code illustrates the use of subkey. 
<subkey>
  <name>SOFTWARE\Microsoft\Active Setup</name>
</subkey>

Parent:
regKey

Child:
 name (minOccurs="1" maxOccurs="1")

See Also

DeleteRegKey, Registry Provider

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