<div class="content" name="FAX_StartCopyToServer" uuid="d4fdc04e-6594-4563-9700-d4cc645b4335"><p>The client calls the <b>FAX_StartCopyToServer (Opnum 68)</b>
method to start a copy of a file to the <b>server queue directory</b> (section <a href="bd422bcf-7ce8-4576-addb-89345ea84f9f" data-linktype="relative-path">3.1.1</a>) for which the
client&#39;s fax user account has access to submit faxes. The server MUST generate
a unique file name and create a file with that name in the <b>server queue
directory</b>. Then the server MUST create a copy handle and return it to the
client to indicate success. </p><p>The copy handle returned by the fax server with the <i>lpHandle</i>
output argument is valid until the fax client calls <b>FAX_EndCopy</b> (section
<a href="efdf1a1b-8f2c-450c-b6a7-36f115aa6ec3" data-linktype="relative-path">3.1.4.1.15</a>), until the
fax server is shut down or restarted, or until an implementation-specific
condition occurs that invalidates the copy handle on the fax server.</p><dl>
<dd>
<div><pre> error_status_t FAX_StartCopyToServer(
   [in] handle_t hFaxHandle,
   [in, string, ref] LPCWSTR lpcwstrFileExt,
   [in, out, string, ref] LPWSTR lpwstrServerFileName,
   [out, ref] PRPC_FAX_COPY_HANDLE lpHandle
 );
</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 <a href="5cbfd38d-7a14-4560-ad24-9ed78f19a3bb" data-linktype="relative-path">3.1.4.1.10</a>) or <b>FAX_ConnectionRefCount</b> (section
<a href="a92941ac-bd07-4a71-af85-c2c157c97cf9" data-linktype="relative-path">3.1.4.1.11</a>) method call
used to connect to the fax server.</p><p><b>lpcwstrFileExt: </b>A null-terminated character
string containing the extension of the file to create on the server. The only
file name extensions that are supported by the server are &#34;.tif&#34; and
&#34;.cov&#34;.</p><p><b>lpwstrServerFileName: </b>Pointer to the buffer
that receives the null-terminated character string containing the name and
specified extension of the file created on the server. The client MUST fill the
buffer with any null-terminated character string of sufficient length to
accommodate the character string that will be received. The server MUST overwrite
this buffer with the null-terminated character string containing the name of
the file on the server upon return. The server SHOULD NOT write more than 255
characters, including the terminating null character, to the returned character
string.</p><p><b>lpHandle: </b>The copy handle identifying this
copy operation.</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 <a href="cbe6c4fb-4dda-4f6c-9701-0d490ba0d105" data-linktype="relative-path">2.2.52</a>, or one
of the other standard errors defined in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>
section <a href="../ms-erref/18d8fbe8-a967-4f1c-ae50-99ca8e491d2d" data-linktype="relative-path">2.2</a>.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>ERROR_ACCESS_DENIED 0x00000005</td>
  <td>Access is denied. The client&#39;s fax user account does not have any of the access rights required for this operation: FAX_ACCESS_SUBMIT, FAX_ACCESS_SUBMIT_NORMAL, or FAX_ACCESS_SUBMIT_HIGH.</td>
 </tr><tr>
  <td>ERROR_INVALID_PARAMETER 0x00000057</td>
  <td>The parameter is incorrect. This error code is returned under any of the following conditions: § The lpcwstrFileExt parameter is set to a NULL pointer value.&lt;173&gt; § The file extension that is specified by lpcwstrFileExt is not &#34;.cov&#34; or &#34;.tif&#34;.</td>
 </tr><tr>
  <td>ERROR_BUFFER_OVERFLOW 0x0000006F</td>
  <td>The file name is too long. The buffer specified by the lpwstrServerFileName parameter does not have sufficient space to accommodate the server file name.</td>
 </tr></tbody></table>
</dd></dl><p><b>Exceptions Thrown:</b> No exceptions are thrown
except those that are thrown by the underlying <a href="46aba9c4-ebb1-4b10-86ac-4bb3025657b9#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a> protocol, <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p></div>