<div class="content"><p> </p><p>The <b>FAX_SetDeviceOrderInGroup (Opnum 55)</b> method is
called by the client. The value for the <i>dwDeviceId</i> parameter can be
obtained using the <b>FAX_EnumPorts</b> (section <span><a href="7143a58b-d7c5-4353-8857-39c7f708e778" data-linktype="relative-path">3.1.4.1.28</a></span>) method
or the <b>FAX_EnumPortsEx</b> (section <span><a href="f26e50ab-ed8e-448d-928c-1820f4a42918" data-linktype="relative-path">3.1.4.1.29</a></span>) method.
The name of the group to remove is specified using the <i>lpwstrGroupName</i>
parameter. The value for <i>lpwstrGroupName</i> can be obtained using <b>FAX_EnumOutboundGroups</b>
(section <span><a href="4e08c709-ab72-48f5-bc1d-36b1dcf274ba" data-linktype="relative-path">3.1.4.1.26</a></span>).</p><p>The order is the 1-based location of the device in the
group. The value of 1 indicates the device is ordered first in the group. The
order of devices in the group determines the order in which they are used to
send outgoing faxes when the group is selected by an outbound <span><a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_e3969a6a-4722-476e-9a36-bb63311ae950" data-linktype="relative-path">routing
rule</a></span>.</p><p>The server MUST validate that the group name length is
within allowed. It MUST validate that the client&#39;s fax user account has access
to manage configuration on the server. It MUST validate that dwNewOrder is
within the limits of the specified group.</p><p>On success, the server MUST set the order of a single device
in the specified group of outbound <span><a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_efaa1290-6d4b-4f44-9e84-35a867069d45" data-linktype="relative-path">routing</a></span> devices.</p><dl>
<dd>
<div><pre> error_status_t FAX_SetDeviceOrderInGroup(
   [in] handle_t hFaxHandle,
   [in, string, ref] LPCWSTR lpwstrGroupName,
   [in] DWORD dwDeviceId,
   [in] DWORD dwNewOrder
 );
</pre></div>
</dd></dl><p><b>hFaxHandle: </b>The RPC binding handle for this
call. The client SHOULD reuse the RPC binding handle used as an input <i>hBinding</i>
argument for the <b>FAX_ConnectFaxServer</b> (section <span><a href="5cbfd38d-7a14-4560-ad24-9ed78f19a3bb" data-linktype="relative-path">3.1.4.1.10</a></span>) or <b>FAX_ConnectionRefCount</b>
(section <span><a href="a92941ac-bd07-4a71-af85-c2c157c97cf9" data-linktype="relative-path">3.1.4.1.11</a></span>) method
call used to connect to the fax server.</p><p><b>lpwstrGroupName: </b>A pointer to a
null-terminated string that uniquely identifies a group. Group names SHOULD be
case-insensitive.</p><p><b>dwDeviceId: </b>A <b>DWORD</b> (<span><a href="../ms-dtyp/cca27429-5689-4a16-b2b4-9325d93e4ba2" data-linktype="relative-path">[MS-DTYP]</a></span>
section <span><a href="../ms-dtyp/262627d8-3418-4627-9218-4ffe110850b2" data-linktype="relative-path">2.2.9</a></span>)
value specifying the identifier of the device in the group. The specified
device MUST exist in the group.</p><p><b>dwNewOrder: </b>A <b>DWORD</b> value specifying
the new 1-based order of the device in the group. If there are N devices in the
group, this value MUST be between 1 and N (inclusive). Other devices are moved
up or down in the group to place the specified device in the specified order.</p><p><b>Return Values: </b>This method MUST return
0x00000000 (ERROR_SUCCESS) for success; otherwise, it MUST return one of the
following error codes, one of the fax-specific errors that are defined in
section <span><a href="cbe6c4fb-4dda-4f6c-9701-0d490ba0d105" data-linktype="relative-path">2.2.52</a></span>, or one of
the other standard errors defined in <span><a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a></span>
section <span><a href="../ms-erref/18d8fbe8-a967-4f1c-ae50-99ca8e491d2d" data-linktype="relative-path">2.2</a></span>.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>ERROR_ACCESS_DENIED</p>
  <p>0x00000005</p>
  </td>
  <td>
  <p>Access is denied. The client&#39;s fax user account does
  not have the required FAX_ACCESS_MANAGE_CONFIG authorization for this
  operation.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_BUFFER_OVERFLOW</p>
  <p>0x0000006F</p>
  </td>
  <td>
  <p>The group name is too long. The length of the character
  string specified by the <i>lpwstrGroupName </i>parameter, excluding the
  length of the null terminator, exceeds 128 characters.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_INVALID_PARAMETER</p>
  <p>0x00000057</p>
  </td>
  <td>
  <p>The parameter is incorrect. This error code is
  returned if any of the following conditions are met:</p>
  <p><span>§<span>  
  </span></span>The <i>dwDeviceId</i> or the <i>dwNewOrder</i> parameter is set
  to a value of 0.</p>
  <p><span>§<span>  
  </span></span>The fax server tried to return
  FAX_ERR_NOT_SUPPORTED_ON_THIS_SKU, but the client fax API version
  (FAX_API_VERSION_0, described in section 3.1.4.1.10) does not support this
  error code.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_REGISTRY_CORRUPT</p>
  <p>0x000003F7</p>
  </td>
  <td>
  <p>The registry is corrupted. The structure of one of the
  files containing registry data is corrupted, or the system&#39;s memory image of
  the file is corrupted, or the file could not be recovered because the
  alternate copy or log was absent or corrupted.</p>
  </td>
 </tr><tr>
  <td>
  <p>FAX_ERR_BAD_GROUP_CONFIGURATION</p>
  <p>0x00001B5B</p>
  </td>
  <td>
  <p>The device specified by <i>dwDeviceId</i> does not
  exist in the group identified by the <i>lpwstrGroupName</i>, or the value of <i>dwNewOrder</i>
  is greater than the number of devices in the group.</p>
  </td>
 </tr><tr>
  <td>
  <p>FAX_ERR_NOT_SUPPORTED_ON_THIS_SKU</p>
  <p>0x00001B63</p>
  </td>
  <td>
  <p>The fax client module API version (as described in
  section 3.1.4.1.10) is FAX_API_VERSION_1 or above, and the fax server is
  running on a version of the operating system that does not support the
  requested operation.<a id="Appendix_A_Target_160"></a><a aria-label="Product behavior note 160" href="056171e7-80bc-45ff-8107-66ba3abb2023#Appendix_A_160" data-linktype="relative-path">&lt;160&gt;</a></p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>Exceptions Thrown: </b>No exceptions are thrown
except those that are thrown by the underlying <span><a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a></span> protocol <span><a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a></span>.</p></div>