/**
     * 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;

    /**
     * Checks if the server has the specified capability

     *
     * @see jcifs.SmbWatchHandle#watch()
     */
    @Override
    public List<FileNotifyInformation> watch() throws CIFSException {
        if (!this.handle.isValid()) {
            throw new SmbException("Watch was broken by tree disconnect");
        }
        try (SmbTreeHandleImpl th = this.handle.getTree()) {

            CommonServerMessageBlockRequest req;
            NotifyResponse resp = null;

     * @param sourceIp the source IP address
     * @return true if attempt is allowed, false if rate limited
     * @throws SmbException if account is locked out
     */
    public boolean checkAttempt(String username, String sourceIp) throws SmbException {
        if (closed.get()) {
            throw new IllegalStateException("Rate limiter is closed");
        }

        // Check global rate limit

     *
     * @return the transport for this session
     */
    SmbTransport getTransport();

    /**
     * Connect to the logon share
     *
     * @throws SmbException if the connection fails
     */
    void treeConnectLogon() throws SmbException;

    /**
     * Gets or creates an SMB tree connection for the specified share and service.
     *
     * @param share the share name to connect to

     * @param doSigning whether message signing should be enabled
     * @return a new SSP authentication context
     * @throws SmbException if context creation fails
     */
    SSPContext createContext(CIFSContext tc, String targetDomain, String host, byte[] initialToken, boolean doSigning) throws SmbException;

    /**
     * Get the security subject associated with these credentials.
     * @return subject associated with the credentials

        SmbAuthException ex = new SmbAuthException(errCode);

        // Assert: type, message derived from code, status mapping, and no cause
        assertNotNull(ex);
        assertTrue(ex instanceof SmbException);
        assertEquals(SmbException.getMessageByCode(errCode), ex.getMessage(), "message should reflect error code mapping");
        assertEquals(expectedStatus, ex.getNtStatus(), "status should map based on code");

    @Test
    @DisplayName("getFid/getFileId throw SmbException when invalid")
    void getters_throw_whenInvalid() {
        when(cfg.isTraceResourceUsage()).thenReturn(false);
        stubValidTree(1L, true, true);
        SmbFileHandleImpl h = new SmbFileHandleImpl(cfg, new byte[] { 0x01, 0x02 }, tree, "//x", 0, 0, 0, 0, 0L);
        // invalidate
        h.markClosed();

        SmbException ex1 = assertThrows(SmbException.class, h::getFid);

        // Happy path delegates; invalid case propagates SmbException
        when(treeConnection.hasCapability(123)).thenReturn(true);
        assertTrue(handle.hasCapability(123));
        verify(treeConnection).hasCapability(123);

        // Exception path
        when(treeConnection.hasCapability(999)).thenThrow(new SmbException("Not connected"));
        SmbException ex = assertThrows(SmbException.class, () -> handle.hasCapability(999));

import java.io.IOException;

import jcifs.smb1.dcerpc.DcerpcError;
import jcifs.smb1.dcerpc.DcerpcException;
import jcifs.smb1.dcerpc.DcerpcHandle;
import jcifs.smb1.dcerpc.rpc;
import jcifs.smb1.smb1.SmbException;

/**
 * Handle for Security Account Manager (SAM) policy operations.
 * This class represents an open handle to a SAM server and provides
 * high-level access to SAM database operations.
 */

    public SSPContext createContext(CIFSContext tc, String targetDomain, String host, byte[] initialToken, boolean doSigning)
            throws SmbException {
        checkNotClosed();

        // Check if authentication has expired
        if (isExpired()) {
            throw new SmbException("Authentication has expired. Please re-authenticate.");
        }

        // Generate session ID for secure key management