3.2.4.10.5 RenameResourceGroup (Opnum 11)

  • Article

The RenameResourceGroup renames an existing resource group.

 [id(5), helpstring("method RenameResourceGroup")] HRESULT RenameResourceGroup(
   [in] BSTR bstrNewResourceGroupName,
   [in] BSTR bstrOldResourceGroupName
 );

bstrNewResourceGroupName: A string that specifies the new name of the resource group.

If this parameter is NULL, E_INVALIDARG MUST be returned.

bstrOldResourceGroupName: A string that specifies the name of the resource group to be renamed.

If this parameter is NULL, E_INVALIDARG MUST be returned.

Return Values: This method returns 0x00000000 for success or a negative HRESULT value (in the following table or in [MS-ERREF] section 2.1.1) if an error occurs.

Return value/code

Description

0x00000000

The call was successful.

0x80070057

E_INVALIDARG

One or more arguments are invalid.

0xC1FF006F

WRM_ERR_ID_VALUE

The specified name contains characters that are valid. The name cannot start with a hyphen ("-"), cannot contain spaces, and cannot contain any of the following characters:

 \   / ? * | : < > " , ;

0xC1FF012D

WRM_ERR_TOO_LONG_RESOURCE_GROUP_ID

The resource group name has exceeded an implementation-defined limit. <121>.

0xC1FF012E

WRM_ERR_RESOURCEGROUPID_INVALID

The specified resource group does not exist.

0Xc1FF012F

WRM_ERR_RESOURCEGROUPID_ALREADY_EXISTS

A resource group with the specified name already exists.

0xC1FF0130

WRM_ERR_RESOURCEGROUPID_RESERVED_WORD

"\" is a reserved name for resource group identifiers.

0xC1FF0138

WRM_ERR_RESERVED_RESOURCEGROUP

The specified resource group is built-in. It cannot be modified.

Additional IWRMResourceGroup interface methods are specified in section 3.2.4.10.