* @param tf the CIFS context containing configuration and credentials
     * @return the final referral for the given DFS path
     * @throws CIFSException if an error occurs during resolution
     * @throws jcifs.smb.SmbAuthException if authentication fails
     */
    DfsReferralData resolve(CIFSContext tf, String domain, String root, String path) throws CIFSException;

    /**
     * Add a referral to the cache
     *

                assertTrue(hasPublic || hasShared, "Should contain expected shares");
                return; // Success, exit retry loop

            } catch (SmbAuthException e) {
                // Some configurations may not allow share listing without specific permissions
                log.warn("Share listing not available due to authentication: {}", e.getMessage());