<div class="content"><p> </p><p>The fax client application calls the <b>FAX_RemoveMessage
(Opnum 67)</b> method to remove a message from a specific <b>Fax Archive Folder</b>.
The <i>dwlMessageId</i> parameter specifies a particular message and can be
obtained using the <b>FAX_EnumMessages</b> (section <span><a href="365c2295-c0f9-44bd-a72b-6db0b16c0f8f" data-linktype="relative-path">3.1.4.1.24</a></span>)
method or the <b>FAX_EnumMessagesEx</b> (section <span><a href="43cf8eed-1cf3-4240-80c5-6f8d1d082084" data-linktype="relative-path">3.1.4.1.25</a></span>) method.</p><p>In response, the server MUST validate whether the client&#39;s
fax user account has access to remove a message from the server. The server
MUST also validate whether the dwlMessageId argument refers to a valid message
in the folder that is specified by the <i>Folder</i> parameter and whether the
client&#39;s fax user account has access to this message.</p><p>On success, the server MUST remove the specified fax message
from the specified <span><a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_9394bf31-7db9-433c-8d3d-ee6a37bf0848" data-linktype="relative-path">archive</a></span> folder.</p><dl>
<dd>
<div><pre> error_status_t FAX_RemoveMessage(
   [in] handle_t hFaxHandle,
   [in] DWORDLONG dwlMessageId,
   [in] FAX_ENUM_MESSAGE_FOLDER Folder
 );
</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>dwlMessageId: </b>A <b>DWORDLONG</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/c575fb47-166c-48cd-a37c-e44cac05c3d6" data-linktype="relative-path">2.2.13</a></span>)
value identifying the fax message to remove from the archive.</p><p><b>Folder: </b>The type of the archive where the
message resides. FAX_MESSAGE_FOLDER_QUEUE is an invalid value for this
parameter.</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 caller does not have the
  required access rights (<b>ALL_FAX_USER_ACCESS_RIGHTS</b> (section <span><a href="6b6ab8ee-03ec-42de-a4fa-fd0b5703b2c3" data-linktype="relative-path">2.2.83</a></span>))
  for this operation.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_INVALID_PARAMETER</p>
  <p>0x00000057</p>
  </td>
  <td>
  <p>This error code is returned under any of the following
  conditions:</p>
  <p><span>§<span>  
  </span></span>The value of the <i>dwlMessageId</i> parameter is 0.</p>
  <p><span>§<span>  
  </span></span>The value of the <i>Folder</i> parameter is not <b>FAX_MESSAGE_FOLDER_INBOX</b>
  or <b>FAX_MESSAGE_FOLDER_SENT_ITEMS</b>.</p>
  </td>
 </tr><tr>
  <td>
  <p>FAX_ERR_FILE_ACCESS_DENIED</p>
  <p>0x00001B60</p>
  </td>
  <td>
  <p>The fax server failed to remove the fax message. When
  trying to delete the fax archived file (the file that represents the fax
  message to be removed), the fax server internally encountered an access
  denied or sharing violation error.</p>
  </td>
 </tr><tr>
  <td>
  <p>FAX_ERR_MESSAGE_NOT_FOUND</p>
  <p>0x00001B61</p>
  </td>
  <td>
  <p>The fax server cannot find the message to be deleted
  (indicated by <i>dwlMessageId</i>). When trying to delete the fax archived
  file (the file that represents the fax message to be removed), the fax server
  internally encountered a file not found error.</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>