<div class="content"><p> </p><p>The <b>FAX_GetConfiguration (Opnum 19)</b> method is called
by the client to query the general configuration of the fax server that is
described by the <b>_FAX_CONFIGURATIONW</b> (section <span><a href="67302e1d-2877-4c18-9b81-f5272fc2aa7d" data-linktype="relative-path">2.2.29</a></span>) structure.</p><p>In response, the server MUST validate that the client&#39;s fax
user account has access to query the configuration of the fax server. It MUST
then allocate memory for the configuration information to be passed out and
fill it with data.</p><p>To indicate success, the server MUST return the buffer that
contains the configuration information, along with the buffer size. The client
SHOULD free the buffer.</p><dl>
<dd>
<div><pre> error_status_t FAX_GetConfiguration(
   [in] handle_t hBinding,
   [out, size_is(, *BufferSize)] LPBYTE* Buffer,
   [out, ref] LPDWORD BufferSize
 );
</pre></div>
</dd></dl><p><b>hBinding: </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>Buffer: </b>A pointer to the address of a buffer
to receive a <b>_FAX_CONFIGURATIONW</b> (section 2.2.29) structure. The
structure contains the current configuration settings for the fax server.</p><p><b>BufferSize: </b>A variable to return the size, in
bytes, of the buffer.</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 <b>FAX_ACCESS_QUERY_CONFIG</b> access rights required for this
  operation.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_NOT_ENOUGH_MEMORY</p>
  <p>0x00000008</p>
  </td>
  <td>
  <p>The server cannot allocate sufficient memory to hold
  the <b>FAX_CONFIGURATION</b> (section <span><a href="c64c03ad-0e74-46d0-89c0-d76b64785dba" data-linktype="relative-path">2.2.28</a></span>) data
  structure to be returned to the client.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_INVALID_PARAMETER</p>
  <p>0x00000057</p>
  </td>
  <td>
  <p>The <i>buffer</i> parameter is set to a NULL pointer
  value.<a id="Appendix_A_Target_104"></a><a aria-label="Product behavior note 104" href="056171e7-80bc-45ff-8107-66ba3abb2023#Appendix_A_104" data-linktype="relative-path">&lt;104&gt;</a></p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_INTERNAL_ERROR</p>
  <p>0x0000054F</p>
  </td>
  <td>
  <p>The server failed to custom marshal the <b>FAX_CONFIGURATION</b>
  to be returned to the client.</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>