<div class="content" name="FAX_CheckValidFaxFolder" uuid="d348202c-d55b-40a9-b346-d6581278ce44"><p>The <b>FAX_CheckValidFaxFolder (Opnum 86)</b> method is
called by the client to check whether the specified path is accessible to the
fax server. </p><p>In response, the server MUST validate the folder path. The
server MUST validate that the client’s fax user account has correct access
rights (ALL_FAX_USER_ACCESS_RIGHTS) and that the folder is not the same as any
of the folders used for persistence of the incoming and outgoing fax queues. On
success, the server MUST confirm that the specified path is accessible for use
by the Fax Service.</p><p>Protocol version FAX_API_VERSION_0 (0x00000000) and
FAX_API_VERSION_1 (0x00010000) fax servers SHOULD NOT implement this call. The
fax client MUST NOT call this method if the protocol version reported by the
server is FAX_API_VERSION_0 (0x00000000) or FAX_API_VERSION_1 (0x00010000). For
more information, see <b>FAX_ConnectFaxServer </b>(section <a href="5cbfd38d-7a14-4560-ad24-9ed78f19a3bb" data-linktype="relative-path">3.1.4.1.10</a>).</p><dl>
<dd>
<div><pre> error_status_t FAX_CheckValidFaxFolder(
   [in] handle_t hBinding,
   [in, string, ref] LPCWSTR lpcwstrPath
 );
</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> 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>lpcwstrPath: </b>A pointer to a null-terminated
character string that contains the path to validate, specified as a complete
file path. The path can be a UNC path or a path that begins with a drive
letter. The path MUST contain a file name. The length of the path, including
the terminating null character, MUST be under 180 characters.</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_FILE_NOT_FOUND 0x00000002</td>
  <td>The path specified by the lpcwstrPath argument has a valid structure (the folder path is valid), but the file does not exist.</td>
 </tr><tr>
  <td>ERROR_PATH_NOT_FOUND 0x00000003</td>
  <td>The path specified by the lpcwstrPath argument has a valid structure, but the folder path does not exist.</td>
 </tr><tr>
  <td>ERROR_ACCESS_DENIED 0x00000005</td>
  <td>Access is denied. The client&#39;s fax user account does not have sufficient rights for this operation (ALL_FAX_USER_ACCESS_RIGHTS).</td>
 </tr><tr>
  <td>ERROR_INVALID_PARAMETER 0x00000057</td>
  <td>The lpcwstrPath argument is NULL, or the path specified by the lpcwstrPath argument is incomplete.</td>
 </tr><tr>
  <td>ERROR_BUFFER_OVERFLOW 0x0000006F</td>
  <td>The length of the path (including length of the terminating null character) specified by the lpcwstrPath argument exceeds 180 characters.</td>
 </tr><tr>
  <td>FAX_ERR_DIRECTORY_IN_USE 0x00001B5F</td>
  <td>The path specified by the lpcwstrPath argument points to a folder currently in use by the fax server, such as the server queue directory or the Fax Archive Folder (section 3.1.1).</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>