CoreRMO::Delete Consumer Instance

Removes a set of consumer instances from the Resource Manager Database. 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
  <candidates>1..1
	<targetSet>1..1</targetSet>
  </candidates>
</executeData>

XML Output Schema

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

<executeData>1..1
  <rowsAffected>1..1</rowsAffected>
</executeData>

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
candidates Description:
Encapsulates data needed to interact with a candidate set.

Parent:
executeData

Child:
targetSet (minOccurs="1" maxOccurs="1")
executeData Description:
 Encapsulates the procedure's input data.

Children:
candidates (minOccurs="1" maxOccurs="1")
rowsAffected (minOccurs="1" maxOccurs="1")
rowsAffected Description:
Integer that specifies the number of consumer instances deleted by this operation.

Parent:
executeData

targetSet Description:
Name of the candidate set that contains consumer instances to delete.

Parent:
candidates

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Add Consumer To Candidates" namespace="CoreRMO"> 
	<executeData>
		<consumerInstance>
		<instanceName>tailspintoys.com</instanceName>
		<typeName>Website</typeName>
		</consumerInstance>
		<candidates>
		<targetSet>siteSet</targetSet>
		<rank>1</rank>
		</candidates>
	</executeData>
	</execute>
	<execute procedure="Delete Consumer Instance" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>siteSet</targetSet>
		</candidates>
	</executeData>
	</execute>
  </procedure>
</request>

Remarks

A consumer instance in the candidate set can be deleted only if there are no mappings associated with the instance. This means all allocations must have been removed and all relationships with other consumer instances, resource instances, or groups must have been previously deleted. If any of the consumer instances in the candidate set cannot be deleted, no instances are deleted.

See Also

Add Consumer Instance, CoreRMO, Resource Manager, Update Consumer Instance

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