CoreRMO::Delete Mapping
Removes mapping relationships between two sets of instances or groups and returns the number of mappings deleted by the operation. 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 <mapping>0..1 <fromSet>1..1</fromSet> <toSet>1..1</toSet> <fromCategory>1..1</fromCategory> <toCategory>1..1</toCategory> <relationship>1..1</relationship> </mapping> </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 executeData Description:
Encapsulates the procedure's input data.Children:
mapping (minOccurs="1" maxOccurs="1")
rowsAffected (minOccurs="1" maxOccurs="1")fromCategory Description:
Category of objects mapped to the toCategory objects.Parent:
mappingfromSet Description:
Set of objects mapped to the toSet objects.Parent:
mappingmapping Description:
Encapsulates a description of a mapping set.Children:
fromCategory (minOccurs="1" maxOccurs="1")
fromSet (minOccurs="1" maxOccurs="1")
relationship (minOccurs="1" maxOccurs="1")
toSet (minOccurs="1" maxOccurs="1")
toCategory (minOccurs="1" maxOccurs="1")relationship Description:
Name of the relationship.Parent:
mappingrowsAffected Description:
Integer that specifies the number of new mappings created by this operation.Parent:
executeDatatoCategory Description:
Category of objects mapped to the fromCategory objects.Parent:
mappingtoSet Description:
Set of objects mapped to the fromSet objects.Parent:
mappingExample
<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> <rank>1</rank> </candidates> </executeData> </execute> <execute procedure="Add Resource Group To Candidates" namespace="CoreRMO"> <executeData> <candidates> <targetSet>groupSet</targetSet> </candidates> <resourceGroup> <groupName>BroadBandServerGroup</groupName> </resourceGroup> </executeData> </execute> <execute procedure="Delete Mapping" namespace="CoreRMO"> <executeData> <mapping> <fromSet>serverSet</fromSet> <toSet>groupSet</toSet> <fromCategory>resourceInstance</fromCategory> <toCategory>resourceGroup</toCategory> <relationship>isABroadBandServer</relationship> </mapping> </executeData> <after source="executeData" sourcePath="rowsAffected" destination="data" /> </execute> </procedure> </request>Remarks
Resource Manager uses mappings internally to associate consumers with resources. Other uses of mappings include identifying group membership or resource ownership.
See Also
Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.