<div class="content"><p> </p><p>The client calls the <b>FaxObs_SetPort (Opnum 15)</b> method
to change the configuration of a fax port (device). The function sets extension
configuration properties that are stored at the device level, such as enabling
or disabling sending and receiving, and the automatic or manual answering of
calls.</p><p>The client MUST set the <i>FaxPortHandle</i> parameter to a
valid fax port handle value returned by the <b>FaxObs_OpenPort</b> (section <span><a href="2c8a37ec-7c13-4a2c-93b7-cf19534846c2" data-linktype="relative-path">3.1.4.2.5</a></span>)
method. The server MUST validate that the client&#39;s fax user account has the
access to change the port configuration. On success, the server MUST modify the
properties of the port as specified by the client.</p><dl>
<dd>
<div><pre> error_status_t FaxObs_SetPort(
   [in] RPC_FAX_PORT_HANDLE FaxPortHandle,
   [in] const FAX_PORT_INFO* PortInfo
 );
</pre></div>
</dd></dl><p><b>FaxPortHandle:</b> An <span><a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_9dfe84e3-a772-4ad1-9a25-1255c1dc0f84" data-linktype="relative-path">RPC context handle</a></span>
that references a fax port.</p><p><b>PortInfo: </b>A pointer to a <b>FAX_PORT_INFO</b>
(section <span><a href="2b46d16c-e74a-4e3b-b50c-0b94f78bebd0" data-linktype="relative-path">2.2.7)</a></span> structure.
The structure contains data to modify the configuration of the specified fax
port. The server MUST ignore the <b>State</b> field of this structure.</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 FAX_PORT_SET access rights.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_INVALID_DATA</p>
  <p>0x0000000D</p>
  </td>
  <td>
  <p>The handle specified by the <i>FaxPortHandle</i>
  argument is not a valid fax port handle obtained by a call to <b>FaxObs_OpenPort</b>.<a id="Appendix_A_Target_201"></a><a aria-label="Product behavior note 201" href="056171e7-80bc-45ff-8107-66ba3abb2023#Appendix_A_201" data-linktype="relative-path">&lt;201&gt;</a></p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_INVALID_PARAMETER</p>
  <p>0x00000057</p>
  </td>
  <td>
  <p>The size of <b>FAX_PORT_INFO</b>, specified in the <b>SizeOfStruct</b>
  field, is incorrect.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_DEVICE_IN_USE</p>
  <p>0x00000964</p>
  </td>
  <td>
  <p>The specified fax port is currently sending or
  receiving a fax transmission. </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>