CoreRMO::Delete Resource Instance
Removes a set of resource 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:
executeDataChildren:
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 resource instances deleted by this operation.Parent:
executeDatatargetSet Description:
Name of the candidate that contains the set of resource instances to delete.Parent:
candidatesExample
<request> <data/> <procedure> <execute procedure="Add Resource To Candidates" namespace="CoreRMO"> <executeData> <resourceInstance> <instanceName>iis-1</instanceName> <instanceLocation>Lab A, Building B</instanceLocation> <typeName>IISServer</typeName> </resourceInstance> <candidates> <targetSet>serverSet</targetSet> </candidates> </executeData> </execute> <execute procedure="Delete Resource Instance" namespace="CoreRMO"> <executeData> <candidates> <targetSet>serverSet</targetSet> </candidates> </executeData> </execute> </procedure> </request>Remarks
Each resource 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 resource instances, consumer instances, or groups must have been previously deleted. If any of the resource instances in the candidate set cannot be deleted, no instances are deleted.
See Also
Add Resource Instance, CoreRMO, Resource Manager, Update Resource Instance
Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.