CoreRMO

CoreRMO

Implements core resource management functions. Used by Microsoft. Provisioning Framework.

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

Procedures

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.

Add Resource Group 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.

See Also

Standard Providers and Namespaces

Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.

Name	Core Resource Management Provider
Version	1
Provider Source	CoreRMO.CoreRMOObj.1

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.
Add Resource Group	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.

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.