<div class="content"><p> </p><p>The <b>FaxObs_GetPageData (Opnum 10)</b> method is called by
the client to retrieve the data from the first page of an outgoing fax job. The
information that is returned in the buffer is an in-memory copy of the first
page of the TIFF file for the job. The value for the <i>JobId</i> parameter can
be obtained by calling the <b>FaxObs_EnumJobs</b> (section <span><a href="e16a0c7e-be32-44ae-977f-2406d937dab2" data-linktype="relative-path">3.1.4.2.9</a></span>)
method.</p><p>In response, the server MUST validate that the <i>JobId</i>
is for a valid job. The server MUST validate that the client&#39;s fax user account
has read access to the job. On success, the server MUST return the first page
of data for the queued or active job in the TIFF 6.0 Class F format in <i>Buffer</i>,
along with the image width and height.</p><p>The client SHOULD free the returned buffer.</p><p>For information about TIFF, see <span><a href="https://go.microsoft.com/fwlink/?LinkId=90416" data-linktype="external">[RFC3302]</a></span>.</p><dl>
<dd>
<div><pre> error_status_t FaxObs_GetPageData(
   [in] handle_t hBinding,
   [in] DWORD JobId,
   [in, out, unique, size_is(,*BufferSize)] 
     LPBYTE* Buffer,
   [in, out] LPDWORD BufferSize,
   [in, out] LPDWORD ImageWidth,
   [in, out] LPDWORD ImageHeight
 );
</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>FaxObs_ConnectionRefCount</b> (section <span><a href="9430f7e2-d21d-4a38-a859-367b74f68a1a" data-linktype="relative-path">3.1.4.2.2</a></span>)
method call used to connect to the fax server. </p><p><b>JobId: </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>)
containing the unique number identifying the fax job that is associated with
the page of data.</p><p><b>Buffer: </b>A pointer to the address of the
returned buffer containing the first page of data in the fax document.</p><p><b>BufferSize: </b>A pointer to a <b>DWORD</b>
variable to receive the size, in bytes, of the buffer pointed to by the <i>Buffer</i>
parameter.</p><p><b>ImageWidth: </b>A pointer to a <b>DWORD</b>
variable to receive the width, in pixels, of the fax image.</p><p><b>ImageHeight: </b>A pointer to a <b>DWORD</b>
variable to receive the height, in pixels, of the fax image.</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_JOB_QUERY access rights. </p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_NOT_ENOUGH_MEMORY</p>
  <p>0x00000008</p>
  </td>
  <td>
  <p>The fax server cannot allocate memory for the data to
  be returned to the client. </p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_INVALID_DATA</p>
  <p>0x0000000D</p>
  </td>
  <td>
  <p>The job identified by the <i>JobId</i> parameter is
  not an outgoing fax job. </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 under any of the following conditions:</p>
  <p><span>§<span>  
  </span></span>One or more of the following parameters are set to NULL pointer
  values: <i>Buffer</i>, <i>BufferSize</i>, <i>ImageWidth</i>, and <i>ImageHeight</i>.<a id="Appendix_A_Target_197"></a><a aria-label="Product behavior note 197" href="056171e7-80bc-45ff-8107-66ba3abb2023#Appendix_A_197" data-linktype="relative-path">&lt;197&gt;</a></p>
  <p><span>§<span>  
  </span></span>The fax server cannot find the fax job indicated by the <i>JobId</i>
  parameter.</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>