CoreRMO

Implements core resource management functions. Used by Microsoft Provisioning Framework (MPF).

Implementation

CoreRMO is installed as part of Resource Manager Engine, into Program Files\Microsoft Provisioning\Resource Manager\Providers\CoreRMO.dll.

Properties
Name Core Resource Management Provider
Version 1
Provider Source CoreRMO.CoreRMOObj.1
Public Methods
Add Candidates To Candidates Copies all members of a source candidate set to a target candidate set and optionally assigns a rank to the copied candidates. Does not overwrite instances or groups that already exist in the target set.
Add Consumer Group To Candidates Adds a consumer group to a candidate set and optionally assigns a rank to all candidates in the set.
Add Consumer Group Adds a consumer group to the Resource Manager Database. Optionally adds the group to a candidate set and assigns each consumer group a rank.
Add Consumer Instance Adds a new consumer instance to the Resource Manager Database. Optionally adds the instance to a candidate set and assigns a rank.
Add Consumer To Candidates Adds a consumer instance to a candidate set and optionally assigns a rank to the instance.
Add Consumer Type Adds a new consumer type definition to the Resource Manager Database.
Add Resource Group To Candidates Adds a resource group to a candidate set and optionally assigns the group a rank.
Adds a new resource group to the Resource Manager Database. Optionally adds the new group to a candidate set and assigns each resource instance a rank.
Add Resource Instance Adds a new resource instance to the Resource Manager Database. Optionally adds the instance to a candidate set and assigns it a rank.
Add Resource To Candidates Adds a specific resource instance to a candidate set and optionally assigns a rank to the resource instance.
Add Resource Type Adds a new resource type definition to the Resource Manager Database.
Construct Mapping Creates mapping relationships between two sets of instances or groups and returns the number of new mappings created by the operation.
Delete Consumer Group Removes a set of consumer groups from the Resource Manager Database.
Delete Consumer Instance Removes a set of consumer instances from the Resource Manager Database.
Delete Consumer Type Removes a consumer type from the Resource Manager Database.
Delete Mapping Removes mapping relationships between two sets of instances or groups and returns the number of mappings deleted by the operation.
Delete Resource Group Removes a set of resource groups from the Resource Manager Database.
Delete Resource Instance Removes a set of resource instances from the Resource Manager Database.
Delete Resource Type Removes a resource type from the Resource Manager Database.
Discard Candidates By Mapping Finds candidates (resource instances, resource groups, consumer instances and consumer groups) based on their relationship with other instances or groups and removes them from the specified candidate set.
Find Candidates By Mapping Finds candidates (resource instances, resource groups, consumer instances, and consumer groups) based on their relationship with other instances or groups and adds them to the specified candidate set.
Find Consumers Finds consumers that match the values provided and adds them to the specified candidate set.
Find Resources Finds resources that match the values provided and adds them to the specified candidate set.
Flush Candidates Removes candidates from candidate sets.
Keep Candidates By Mapping Identifies candidates (resource instances, resource groups, consumer instances, and consumer groups) that should remain in a specified candidate set based on their relationship with other instances or groups.
Keep Top Candidates Removes all but the top n ranked candidates from a candidate set.
List Candidates Returns a list of the candidates in the specified candidate set that match the specified category. The elements returned depend on the category specified.
List Consumer Models Returns a list of currently registered consumer models from the Resource Manager Database.
List Consumer Types Returns a list of all the consumer types registered with the Resource Manager Database.
List Resource Models Returns a list of currently registered resource models from the Resource Manager Database.
List Resource Types Returns a list of all resource types registered with the Resource Manager Database.
Query Consumer Type Queries the Resource Manager for the specified consumer type and returns its consumer model name and consumer type description.
Query Resource Type Queries the Resource Manager for the specified resource type and returns its resource model name and resource type description.
Raise Notifications As Events Collects current notifications from the Resource Manager Database and sends them to the event log of the process controller that executes the provisioning request. Once notifications are raised, this function deletes them from the database.
Random Rank Candidates Applies a random ranking to all candidates in the candidate set that have not already been ranked.
Retrieve Notifications Returns a list of the current notifications in the Resource Manager Database, then deletes the notifications from the database.
Update Consumer Group Updates the group name and/or group description attributes for each consumer group in a candidate set.
Update Consumer Instance Updates the instance name and description and the consumer type name for each consumer instance in a candidate set.
Update Consumer Type Updates the name, model, or description for a consumer type.
Update Resource Group Updates the group name and/or description attributes for the resource group in the candidate set.
Update Resource Instance Updates one or more of the following values for each resource instance in the candidate set:
  • Instance name
  • Instance description
  • Instance location
  • Instance "online" status
  • Instance "provisionable" status
  • Resource type name
Update Resource Type Updates the name, model, or description for a resource type.
Errors
HRESULT Description
0xC2201BBC An unexpected error occurred.
0xC2201BBD The specified resource model does not exist.
0xC2201BBE The specified resource type does not exist.
0xC2201BBF The specified resource instance does not exist.
0xC2201BC0 The specified resource group does not exist.
0xC2201BC1 The specified resource instance is still being used.
0xC2201BC2 The specified resource group is still being used.
0xC2201BC3 The specified consumer model does not exist.
0xC2201BC4 The specified consumer type does not exist.
0xC2201BC5 The specified consumer instance does not exist.
0xC2201BC6 The specified consumer group does not exist.
0xC2201BC7 The specified consumer type is still being used.
0xC2201BC8 The specified consumer instance is still being used.
0xC2201BC9 The specified consumer group is still being used.
0xC2201BCA The specified resource type is still being used.
0xC2201BCB The specified resource model already exists.
0xC2201BCC The specified resource type already exists.
0xC2201BCD The specified resource instance already exists.
0xC2201BCE The specified resource group already exists.
0xC2201BCF The specified consumer model already exists.
0xC2201BD0 The specified consumer type already exists.
0xC2201BD1 The specified consumer instance already exists.
0xC2201BD2 The specified consumer group already exists.
0xC2201BD3 The specified resource does not have capacity data.
0xC2201BD4 The specified resource already has capacity data.
0xC2201BD5 The specified resource type already has instance data.
0xC2201BD6 An SQL error occurred during processing: %1.
0xC2201BD7 Failed to set output node %1 to value %2.
0xC2201BD8 Failed to append XML.
0xC2201BD9 Failed to get value from node: %1.
0xC2201BDA Input does not contain required node: %1.
0xC2201BDB Input does not contain required attribute: %1.
0xC2201BDC Value for input element %1 exceeds allowable length %2.
0xC2201BDD A non- integer value was supplied for argument %1 which requires an integer value.
0xC2201BDE A non- integer or negative value was supplied for argument %1 which requires a positive integer value.
0xC2201BDF A resource type was added or updated with the same name as an existing type.
0xC2201BE0 A consumer type was added or updated with the same name as an existing type.
0xC2201BE1 A resource instance was added or updated with the same name, location and type as an existing instance, or the resource type no longer exists.
0xC2201BE2 A consumer instance was added or updated with the same name and type as an existing instance, or the consumer type no longer exists.
0xC2201BE3 A resource group was added or updated with the same name as an existing group.
0xC2201BE4 A consumer group was added or updated with the same name as an existing group.
0xC2201BE5 A mapping was added with same ID as an existing mapping.
0xC2201BE6 The value supplied for argument %1 caused an arithmetic overflow.
0xC2201C21 The resource is full.
0xC2201C22 There were not enough resources available to satisfy the request.
0xC2201C23 There were no ranked resources found in the candidate set.
0xC2201C24 There were no consumers found in the candidate set.
0xC2201C25 The resource is unknown to the block model.
0xC2201C26 Both a fill ratio and an actual value were provided for an allocation or update, but only one or the other can be used.
0xC2201C27 A fill ratio was provided without an virtual allocation value.
0xC2201C28 No allocations were found to update.
0xC2201C29 No allocations were found to delete.
0xC2201C2A One or more input parameters failed validation.
0xC2201C2B The resource type no longer exists or the default data is invalid.
0xC2201C2C The resource instance no longer exists or the capacity data is invalid.
0xC2201C2D Either the resource or the consumer no longer exist or an allocation has already been released.
0xC2201C2E The value of the rankUsing parameter should be one of the following four values: actualFree, virtualFree, actualMax, or virtualMax.
0xC2201C2F A procedure tried to release more resources than are currently allocated to a consumer.
0xC2201C30 There is no capacity data for the specified resource instance.
0xC2201C31 There is no capacity data for the specified resource type.
0xC2201C32 No resources were found in the candidate set that had capacity data to update.
0x82201C33 Verification found that the resource instance whose name is %1 of type %2 at location %3 has an actual max value that is above the acceptable range.
0x82201C34 Verification found that the resource instance whose name is %1 of type %2 at location %3 has an actual max value that is below the acceptable range.
0x82201C35 Verification found that the resource instance whose name is %1 of type %2 at location %3 has an actual free value that is above the acceptable range.
0x82201C36 Verification found that the resource instance whose name is %1 of type %2 at location %3 has an actual free value that is below the acceptable range.
0x82201C37 Verification found that the resource instance whose name is %1 of type %2 at location %3 has an virtual max value that is above the acceptable range.
0x82201C38 Verification found that the resource instance whose name is %1 of type %2 at location %3 has an virtual max value that is below the acceptable range.
0x82201C39 Verification found that the resource instance whose name is %1 of type %2 at location %3 has an virtual free value that is above the acceptable range.
0x82201C3A Verification found that the resource instance whose name is %1 of type %2 at location %3 has an virtual free value that is below the acceptable range.
0x82201C3B The resource instance whose name is %1 of type %2 at location %3 has reached the actual free warning level.
0x82201C3C The resource instance whose name is %1 of type %2 at location %3 has reached the virtual free warning level.
0xC2201C3D An arithmetic overflow occurred because the resource capacity specified was too large.
0xC2201C3E An attempt was made to add capacity data for a resource type with no associated model data.
 Applies To
[an error occurred while processing this directive]