CoreRMO::Delete Consumer Group

Removes a set of consumer groups from the Resource Manager Database. If the function succeeds, all consumer groups in the candidate set are deleted; otherwise, no groups are deleted. 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 and output data.

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

Parent:
executeData

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

Parent:
candidates

Example

<request>
  <data/>
  <procedure>  
	<execute procedure="Add Consumer Group To Candidates" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>premiumSitesGroupSet</targetSet>
		</candidates>
		<consumerGroup>
		<groupName>PremiumWebsites</groupName>
		</consumerGroup>
	</executeData>
	</execute>
	<execute procedure="Delete Consumer Group" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>premiumSitesGroupSet</targetSet>
		</candidates>
	</executeData>
	</execute>
  </procedure>
</request>

Remarks

This function will fail if any of the consumer groups being deleted has a mapping associated with it.

See Also

Add Consumer Group, CoreRMO, Resource Manager, Update Consumer Group

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