<div class="content"><p align="right"><a href="https://msdn.microsoft.com/en-us/library/2915b539-41c0-4468-81fd-6c6d2e7edbe5" data-linktype="external">msdn link</a></p><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 <a href="e02d79c2-ae0b-4812-8919-9f2dbc223eb6" data-linktype="relative-path">ApiCreateGroup (section 3.1.4.2.43)</a>
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 <a href="694e5e7a-5833-4f3d-b47e-323ee1d452c2#gt_b069acb4-e364-453e-ac83-42d469bb339e" data-linktype="relative-path">Unicode string</a> 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 <a href="875e8121-a523-4a3e-b652-bc0841b56d93" data-linktype="relative-path">CLUSTER_CREATE_GROUP_INFO_RPC (section 2.2.3.21)</a>
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>
  <p>0x00000001</p>
  <p>ClusGroupTypeReserved1</p>
  </td>
  <td>
  <p>Reserved for local use.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000002</p>
  <p>ClusGroupTypeReserved2</p>
  </td>
  <td>
  <p>Reserved for local use.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000004</p>
  <p>ClusGroupTypeReserved3</p>
  </td>
  <td>
  <p>Reserved for local use.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000005</p>
  <p>ClusGroupTypeReserved4</p>
  </td>
  <td>
  <p>Reserved for local use.</p>
  </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>
  <p>0x00000000</p>
  <p>ERROR_SUCCESS</p>
  </td>
  <td>
  <p>The operation completed successfully.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000046</p>
  <p>ERROR_SHARING_PAUSED</p>
  </td>
  <td>
  <p>The remote server is paused or is in the process of
  being started.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00001392</p>
  <p>ERROR_OBJECT_ALREADY_EXISTS</p>
  </td>
  <td>
  <p>A group with the designated name already exists.</p>
  </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 <a href="ca75805a-4b39-4074-8b5b-dbaae6e81b1f" data-linktype="relative-path">3.2.4.6</a>.</p>
</dd></dl><p><b>rpc_status: </b>A 32-bit integer used to indicate
success or failure. The <a href="694e5e7a-5833-4f3d-b47e-323ee1d452c2#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a>
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 <a href="https://go.microsoft.com/fwlink/?LinkId=89824" data-linktype="external">[C706]</a>.</p><p><b>Return Values: </b>This method MUST return a valid
HGROUP_RPC context handle, as specified in section <a href="90b10b4b-a957-44a5-a5bc-912fed366161" data-linktype="relative-path">2.2.1.3</a>, to indicate
success. Otherwise, it MUST return NULL.</p></div>