CoreRMO::Flush Candidates
Removes candidates from candidate sets. Used by Microsoft. Provisioning Framework (MPF).
It is a wise practice to call Flush Candidates to clear candidate sets whenever candidates are no longer needed. This ensures that other procedure calls referencing the candidate set will not operate on extraneous candidates.
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>0..1 <targetSet>0..1</targetSet> <category>0..1</category> </candidates> </executeData>XML Output Schema
Flush Candidates 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 candidates Description:
Encapsulates data needed to interact with a candidate set.Parent:
executeDataChildren:
category (minOccurs="0" maxOccurs="1")
targetSet (minOccurs="0" maxOccurs="1")category Description:
Category of objects to flush from the candidate set: resourceInstance, resourceGroup, consumerInstance, or consumerGroup.Parent:
candidatesexecuteData Description:
Encapsulates the procedure's input data.Child:
candidates (minOccurs="0" maxOccurs="1")targetSet Description:
Candidate set to flush.Parent:
candidatesExample
<request> <data/> <procedure> <execute procedure="Flush Candidates" namespace="CoreRMO"> <executeData> <candidates> <targetSet>serverSet</targetSet> </candidates> </executeData> </execute> </procedure> </request>Remarks
If targetSet and category are specified, this function removes only candidates from the specified candidate set that match the specified category. If no optional parameters are specified, it removes all candidates from every candidate set.
See Also
Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.