* not accepted, an <tt>SmbAuthException</tt> will be thrown. If an error
     * occurs an <tt>SmbException</tt> will be thrown. If the credentials are
     * valid, the method will return without throwing an exception. See the
     * last <a href="../../../faq.html">FAQ</a> question.
     * <p>
     * See also the <tt>jcifs.smb.client.logonShare</tt> property.
     * 

        "A duplicate name exists on the network.", "The network name cannot be found.", "ERRnomoreconn.", "The file exists.",
        "The parameter is incorrect.", "Too many Uids active on this session.", "The Uid is not known as a valid user identifier on this session.",
        "The pipe has been ended.", "The filename, directory name, or volume label syntax is incorrect.", "The directory is not empty.",

     * @return service
     */
    String getService ();


    /**
     * @return whether the share is in DFS
     */
    boolean isShareDfs ();


    /**
     * @return whether the tree id is a valid one
     */
    boolean isValidTid ();

 *
 */
public interface SmbFileHandle extends AutoCloseable {

    /**
     * @return the tree
     */
    SmbTreeHandle getTree ();


    /**
     * @return whether the file descriptor is valid
     */
    boolean isValid ();


    /**
     * @param lastWriteTime
     * @throws CIFSException
     */
    void close ( long lastWriteTime ) throws CIFSException;


    /**

     * 
     * @throws CIFSException
     *
     * @see java.lang.AutoCloseable#close()
     */
    @Override
    void close () throws CIFSException;


    /**
     * @return whether the FD is open and valid
     */
    boolean isOpen ();


    /**
     * @return whether the FD was previously open but became invalid
     */
    boolean isStale ();


    /**
     * @param type

 * <code>smb1://workgroup/</code> lists servers, the <code>smb1://</code>
 * URL lists all available workgroups on a netbios LAN. Again,
 * in this context many methods are not valid and return default
 * values(e.g. <code>isHidden</code> will always return false).
 * </td></tr>
 * 
 * <tr><td width="20%"><code>smb1://angus.foo.net/d/jcifs/smb1/pipes.doc</code></td><td>

                if ( sae.getNtStatus() == NtStatus.NT_STATUS_ACCESS_VIOLATION ) {
                    /*
                     * Server challenge no longer valid for
                     * externally supplied password hashes.
                     */
                    HttpSession ssn = req.getSession(false);
                    if ( ssn != null ) {

 * specified by the <tt>UniAddress</tt> parameter. If the credentials are
 * not accepted, an <tt>SmbAuthException</tt> will be thrown. If an error
 * occurs an <tt>SmbException</tt> will be thrown. If the credentials are
 * valid, the method will return without throwing an exception. See the
 * last <a href="../../../faq.html">FAQ</a> question.
 * <p>
 * See also the <tt>jcifs.smb1.smb1.client.logonShare</tt> property.
 */

        if ( !isValid() ) {
            throw new SmbException("Descriptor is no longer valid");
        }
        return this.fid;
    }


    public byte[] getFileId () throws SmbException {
        if ( !isValid() ) {
            throw new SmbException("Descriptor is no longer valid");
        }
        return this.fileId;
    }


    /**
     * @return the initialSize

                            ": " + sae );
                }
                if( sae.getNtStatus() == sae.NT_STATUS_ACCESS_VIOLATION ) {
                    /* Server challenge no longer valid for
                     * externally supplied password hashes.
                     */
                    HttpSession ssn = req.getSession(false);
                    if (ssn != null) {