}

    /**
     * Perform a single reconnection attempt
     * @param info the handle information
     * @param attempt the current attempt number (0-based)
     * @param originalCause the original exception that triggered reconnection
     * @return a future that completes with success or failure
     */
    private CompletableFuture<HandleInfo> attemptReconnect(HandleInfo info, int attempt, Exception originalCause) {

 * This client will attempt to execute requests multiple times before giving up, with configurable
 * retry counts and intervals between attempts.
 *
 * <p>The client supports a RequestListener interface to monitor the request lifecycle and handle
 * exceptions during retries.</p>
 *
 * <p>Key features:</p>
 * <ul>
 *   <li>Configurable maximum retry attempts</li>
 *   <li>Adjustable interval between retries</li>

        try {
            method.invoke(multiChannelManager, localhost, loopback);
            // If it doesn't throw, that's unexpected for localhost
            fail("Expected CIFSException for localhost multi-channel attempt");
        } catch (java.lang.reflect.InvocationTargetException e) {
            // We expect this to fail, but it should be a CIFSException, not a NullPointerException
            assertTrue(e.getCause() instanceof CIFSException);

        });
    }

    /**
     * Handles user login with the provided credentials.
     *
     * @param form the login form containing username and password
     * @return the HTML response after login attempt
     */
    @Execute
    public HtmlResponse login(final LoginForm form) {
        validate(form, messages -> {}, () -> asIndexPage(form));
        verifyToken(() -> asIndexPage(form));

     *
     * @param creds the credentials to use
     * @return a child context using using the given credentials
     */
    CIFSContext withCredentials(Credentials creds);

    /**
     * Attempt to renew credentials after authentication failure
     *
     * @param locationHint URL or location hint for credential renewal
     * @param error the error that triggered renewal

                    logger.debug("Token expired: expiryTime={}, currentTime={}", tokenExpiryTime, currentTime);
                }
                return false;
            }
            // Attempt to refresh token using MSAL4J silent authentication
            try {
                final EntraIdAuthenticator authenticator = ComponentUtil.getComponent(EntraIdAuthenticator.class);

            return false;
        }
    }

    /**
     * Advances to the next file entry in the enumeration.
     *
     * @param last whether this is the last attempt to advance
     * @return the next file entry, or null if no more entries
     * @throws CIFSException if an error occurs during enumeration
     */

        context.put("sessionId", "abc123def456");
        context.put("username", "******@****.***");

        logger.logEvent(EventType.AUTHENTICATION_SUCCESS, Severity.INFO, "Login attempt", context);

        // The test verifies that the logger runs without errors when masking is enabled
        Map<EventType, Long> stats = logger.getStatistics();

    void readBytesWireFormatTooShortException() {
        Configuration cfg = mock(Configuration.class);
        SmbComLockingAndX cmd = new SmbComLockingAndX(cfg);
        // arrays of size 1 so internal method will attempt to decode a range
        setField(cmd, "unlocks", new LockingAndXRange[] { new LockingAndXRange(false) });
        setField(cmd, "locks", new LockingAndXRange[] { new LockingAndXRange(false) });

     * This is a required field that tracks repeated failures for the same URL.
     */
    @Required
    @ValidateTypeFailure
    public String errorCount;

    /**
     * The timestamp of the last access attempt for this URL.
     * This is a required field indicating when the failure last occurred.
     */
    @Required
    public String lastAccessTime;

    /**