*/
    FILE_SERVER_WITNESS,

    /**
     * Scale-out file server witness for scale-out deployments
     */
    SCALE_OUT_WITNESS,

    /**
     * DFS namespace witness for distributed file system resources
     */
    DFS_WITNESS

     * this method will return the referral path to which it maps. Otherwise
     * <code>null</code> is returned.
     */

    /**
     * Returns the DFS path for this file if it resides in a DFS share
     *
     * @return the DFS path or null if not in DFS
     * @throws SmbException if an error occurs while resolving the DFS path
     */

 * DFS referrals. (E.g. a resource with a DFS root's parent will still point to the DFS root not the share it's actually
 * located in).
 * - share + uncpath within it: This is the relevant information for most SMB requests. Both are adjusted by DFS
 * referrals. Nested resources will inherit the information already resolved by the parent resource.
 *

        tree.send(request, response);

        // Verify session.send was called
        verify(session).send(request, response);
        assertEquals(123, request.tid);
        // For A: service with DFS, path should be modified (share name is uppercased)
        assertEquals("\\testHost\\TESTSHARE\\testPath", request.path);

    /** Security signatures supported flag */
    int FLAGS2_SECURITY_SIGNATURES = 0x0004;
    /** Extended security negotiation flag */
    int FLAGS2_EXTENDED_SECURITY_NEGOTIATION = 0x0800;
    /** Resolve paths in DFS flag */
    int FLAGS2_RESOLVE_PATHS_IN_DFS = 0x1000;
    /** Permit read if execute permission flag */
    int FLAGS2_PERMIT_READ_IF_EXECUTE_PERM = 0x2000;
    /** 32-bit status codes flag */
    int FLAGS2_STATUS32 = 0x4000;

 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
package jcifs;

/**
 * Information returned in DFS referrals
 *
 * @author mbechler
 *
 * <p>This interface is intended for internal use.</p>
 */
public interface DfsReferralData {

    /**
     * Unwrap the referral data to a specific implementation type

        // Arrange: configure the mock to throw
        doThrow(new CIFSException("DFS resolution failed")).when(handle).ensureDFSResolved();

        // Act + Assert: exception is propagated with message
        CIFSException ex = assertThrows(CIFSException.class, () -> handle.ensureDFSResolved());
        assertEquals("DFS resolution failed", ex.getMessage());
        verify(handle, times(1)).ensureDFSResolved();
    }

 */
public interface SmbTreeHandleInternal extends SmbTreeHandle {

    /**
     * Releases this tree handle back to the pool for reuse
     */
    void release();

    /**
     * Ensures that DFS referrals have been resolved for this tree
     * @throws SmbException if an SMB-specific error occurs
     * @throws CIFSException if a general CIFS error occurs
     */
    void ensureDFSResolved() throws CIFSException;

    }

    /**
     * Test the getEntries() method with a populated DfsEnumArray200.
     * Verifies that the DFS entries are correctly converted to FileEntry objects.
     */
    @Test
    void testGetEntries() {
        // Given
        MsrpcDfsRootEnum dfsRootEnum = new MsrpcDfsRootEnum("test-server");

 *
 * @author mbechler
 *
 */
public class Smb2IoctlRequest extends ServerMessageBlock2Request<Smb2IoctlResponse> implements RequestWithFileId {

    /**
     * Function code to retrieve DFS referrals
     */
    public static final int FSCTL_DFS_GET_REFERRALS = 0x0060194;
    /**
     * Function code to peek at named pipe data without removing it
     */