The following table describes the XML elements and attributes. Unless otherwise indicated, the data type is string.

Once this function is executed, only ranked candidates will remain in the candidate set. A lower rank value means a high rank; in the example below, Printer-A has a higher rank than Printer-B. Unranked candidates will be removed even if the set then contains less than n elements.

If multiple candidates share the same rank, and the rank is on the boundary of being included or excluded, the function non-deterministically chooses which candidate to include in the set. The following example illustrates the dilemma.

Count = 4

Since Printers D and E both have rank 4, the function will choose one of the printers to keep. This choice may not be random.

<executeData>1..1
  <candidates>1..1
	<targetSet>1..1</targetSet>
	<category>1..1</category>
	<count>1..1</count>
  </candidates>
</executeData>

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.

<request>
  <data/>
  <procedure>  
	<execute procedure="Find Resources" namespace="CoreRMO"> 
	<executeData>
		<resourceInstance>
		<typeName>IISServer</typeName>
		</resourceInstance>
		<candidates>
		<targetSet>serverSet</targetSet>
		</candidates>
	</executeData>
	</execute>
	<execute procedure="Random Rank Candidates" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>serverSet</targetSet>
		<category>resourceInstance</category>
		</candidates>
	</executeData>
	</execute>
	<execute procedure="Keep Top Candidates" namespace="CoreRMO"> 
	<executeData>
		<candidates>
		<targetSet>serverSet</targetSet>
		<category>resourceInstance</category>
		<count>1</count>
		</candidates>
	</executeData>
	</execute>
  </procedure>
</request>

Keep Top Candidates does not return data.

• Hosted Messaging and Collaboration version 4.5
• Hosted Messaging and Collaboration version 4.0
• Hosted Messaging and Collaboration version 3.5
• Hosted Messaging and Collaboration version 3.0
• Windows-based Hosting version 4.5
• Windows-based Hosting version 4.0
• Windows-based Hosting version 3.5
• Windows-based Hosting for Applications version 1.0