<div class="content" name="ApiCreateGroupEx" uuid="2915b539-41c0-4468-81fd-6c6d2e7edbe5"><p>(Protocol Version 3) The ApiCreateGroupEx method SHOULD<a id="Appendix_A_Target_108"></a><a aria-label="Product behavior note 108" href="1d58eff8-a042-478c-972c-8e9c76a3f978#Appendix_A_108" data-linktype="relative-path">&lt;108&gt;</a> extend functionality of the <span><a href="e02d79c2-ae0b-4812-8919-9f2dbc223eb6" data-linktype="relative-path">ApiCreateGroup (section 3.1.4.2.43)</a></span>
method, allowing the client to provide additional information about the group
being created.</p><p>The server MUST handle this method in the same manner as
ApiCreateGroup (section 3.1.4.2.43) except as specified later in this
section for the <i>pGroupInfo</i> parameter.</p><dl>
<dd>
<div><pre> HGROUP_RPC ApiCreateGroupEx(
   [in, string] LPCWSTR lpszGroupName,
   [in, unique] PCLUSTER_CREATE_GROUP_INFO_RPC pGroupInfo,
   [out] error_status_t *Status,
   [out] error_status_t *rpc_status
 );
</pre></div>
</dd></dl><p><b>lpszGroupName: </b>A <span><a href="694e5e7a-5833-4f3d-b47e-323ee1d452c2#gt_b069acb4-e364-453e-ac83-42d469bb339e" data-linktype="relative-path">Unicode string</a></span> that
is the name associated with the group.</p><p><b>pGroupInfo: </b>Contains information about the
group to be created. The client MUST set the <b>dwVersion</b> field of the <span><a href="875e8121-a523-4a3e-b652-bc0841b56d93" data-linktype="relative-path">CLUSTER_CREATE_GROUP_INFO_RPC (section 2.2.3.21)</a></span>
to 0x00000001. Except for the following reserved values, the client sets the <b>dwGroupType</b>
field to an arbitrary value that the client can use to associate meaning or
context with the group. Upon successful creation of the group, the server MUST
set the group type to the value specified by the client and the server MUST
treat all values identically. If a client does not need to associate any
particular meaning or context with the group, the client SHOULD set the group
type to 0x0000270F (ClusGroupTypeUnknown).</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x00000001 ClusGroupTypeReserved1</td>
  <td>Reserved for local use.</td>
 </tr><tr>
  <td>0x00000002 ClusGroupTypeReserved2</td>
  <td>Reserved for local use.</td>
 </tr><tr>
  <td>0x00000004 ClusGroupTypeReserved3</td>
  <td>Reserved for local use.</td>
 </tr><tr>
  <td>0x00000005 ClusGroupTypeReserved4</td>
  <td>Reserved for local use.</td>
 </tr></tbody></table>
</dd></dl><p><b>Status: </b>Indicates the status of this
operation. The server MUST set this parameter to one of the following error
codes:</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x00000000 ERROR_SUCCESS</td>
  <td>The operation completed successfully.</td>
 </tr><tr>
  <td>0x00000046 ERROR_SHARING_PAUSED</td>
  <td>The remote server is paused or is in the process of being started.</td>
 </tr><tr>
  <td>0x00001392 ERROR_OBJECT_ALREADY_EXISTS</td>
  <td>A group with the designated name already exists.</td>
 </tr></tbody></table>
</dd>
<dd>
<p>For any other condition, the server sets the <i>Status</i>
parameter to a value that is not one of the values listed in this table. The
client MUST treat all values not listed in this table identically, except as
specified in section <span><a href="ca75805a-4b39-4074-8b5b-dbaae6e81b1f" data-linktype="relative-path">3.2.4.6</a></span>.</p>
</dd></dl><p><b>rpc_status: </b>A 32-bit integer used to indicate
success or failure. The <span><a href="694e5e7a-5833-4f3d-b47e-323ee1d452c2#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a></span> runtime MUST
indicate, by writing to this parameter, whether it succeeded in executing this
method on the server. The encoding of the value passed in this parameter MUST
conform to encoding for comm_status and fault_status, as specified in Appendix
E of <span><a href="https://go.microsoft.com/fwlink/?LinkId=89824" data-linktype="external">[C706]</a></span>.</p><p><b>Return Values: </b>This method MUST return a valid
HGROUP_RPC context handle, as specified in section <span><a href="90b10b4b-a957-44a5-a5bc-912fed366161" data-linktype="relative-path">2.2.1.3</a></span>, to
indicate success. Otherwise, it MUST return NULL.</p></div>