<div class="content" name="CreateResourceGroup" uuid="22697fd7-71a7-428b-b9e5-a608a7e8ddcc"><p>The CreateResourceGroup function creates a new <a href="e371cc74-bf4c-4870-8afe-5062cc628b4f#gt_04c2dc43-6f4a-432d-bca6-ceeef2d5f2ae" data-linktype="relative-path">resource group</a>.</p><dl>
<dd>
<div><pre> [id(3), helpstring(&#34;method CreateResourceGroup&#34;)] HRESULT CreateResourceGroup(
   [in] BSTR bstrResourceGroupInfo
 );
</pre></div>
</dd></dl><p><b>bstrResourceGroupInfo: </b>A string that specifies
a new resource group, in the form of a <a href="b31d31ce-1030-43c6-abff-ea77edb2d5b7" data-linktype="relative-path">ProcessMatchingCriteria (section 2.2.5.24)</a>
element (section 2.2.5.24). For an example, see <a href="84880779-fe33-4629-8c94-31d81a429585" data-linktype="relative-path">ProcessMatchingCriteria</a>
example (section 4.2.20). </p><dl>
<dd>
<p>If this parameter is NULL, <b>E_INVALIDARG</b> MUST
be returned.</p>
</dd></dl><p><b>Return Values: </b>This method returns 0x00000000
for success or a negative <a href="e371cc74-bf4c-4870-8afe-5062cc628b4f#gt_799103ab-b3cb-4eab-8c55-322821b2b235" data-linktype="relative-path">HRESULT</a>
value (in the following table or in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>
section <a href="../ms-erref/705fb797-2175-4a90-b5a3-3918024b10b8" data-linktype="relative-path">2.1.1</a>)
if an error occurs.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x00000000 S_OK</td>
  <td>The operation was successfully done.</td>
 </tr><tr>
  <td>0x80070057 E_INVALIDARG</td>
  <td>One or more arguments are invalid.</td>
 </tr><tr>
  <td>0xC1FF006F WRM_ERR_ID_VALUE</td>
  <td>The specified name contains characters that are not valid. The name cannot start with a hyphen (&#34;-&#34;), cannot contain spaces, and cannot contain any of the following characters:   \   / ? * | : &lt; &gt; &#34; , ;</td>
 </tr><tr>
  <td>0xC1FF012F WRM_ERR_RESOURCEGROUPID_ALREADY_EXISTS</td>
  <td>The request has been aborted because the resource group with the specified name already exists.</td>
 </tr><tr>
  <td>0xC1FF0136 WRM_ERR_PMC_LIMIT_EXCEEDED</td>
  <td>The total number of resource groups has exceeded an implementation-defined limit.&lt;120&gt;.</td>
 </tr><tr>
  <td>0xC1FF0139 WRM_ERR_CANNOT_CREATE_RESERVED_RESOURCEGROUP</td>
  <td>A user-created resource group cannot have the same name as that of a built-in resource group.</td>
 </tr></tbody></table>
</dd></dl><p>Additional <a href="a314adf4-0bff-40d1-a5b2-d909dcf176a3" data-linktype="relative-path">IWRMResourceGroup</a>
interface methods are specified in section 3.2.4.10.</p></div>