// When & Then
        assertThrows(UnknownHostException.class, () -> {
            mockAddress.toInetAddress();
        }, "Should propagate UnknownHostException");
    }

    @Test
    @DisplayName("firstCalledName should return valid name for session establishment")
    void testFirstCalledNameContract() {
        // Given

            when(mockSmbPipeHandleInternal.getSessionKey()).thenReturn(expectedKey);
            assertArrayEquals(expectedKey, handle.getSessionKey());
        }

        @Test
        @DisplayName("Should propagate CIFSException when getting session key")
        void testGetSessionKey_ThrowsCIFSException() throws Exception {
            DcerpcPipeHandle handle = createMockedDcerpcPipeHandle();

        // Then it should be rejected because the ARCHIVE attribute is not present
        assertFalse(dosFileFilter.accept(mockFile));
    }

    /**
     * Tests that the accept method correctly propagates SmbException when
     * {@link SmbFile#getAttributes()} throws it.
     * @throws SmbException if an SMB error occurs.
     */
    @Test
    void testAccept_ThrowsSmbException() throws SmbException {

        boolean result = filter.accept(null, "anything");

        assertTrue(result, "Filter should accept when dir is null as defined");
    }

    /**
     * Exception flow: filter throws SmbException and it propagates to caller.
     */
    @Test
    @DisplayName("throws SmbException as declared by contract")
    void throwsSmbExceptionFromFilter() {
        SmbFilenameFilter filter = (dir, name) -> {

        TestIterator iterator = new TestIterator(null);
        iterator.close();

        verify(delegate).close();
    }

    @Test
    @DisplayName("Close propagates exception")
    void closeException() throws CIFSException {
        when(delegate.hasNext()).thenReturn(false);
        doThrow(new CIFSException("Close failed")).when(delegate).close();

            doThrow(testException).when(mockSession).close();

            Exception thrownException = assertThrows(Exception.class, mockSession::close, "close() should propagate exceptions");
            assertEquals("Test close exception", thrownException.getMessage());
        }
    }

    @Nested
    @DisplayName("Configuration Access Tests")
    class ConfigurationAccessTest {

            assertThrows(SmbUnsupportedOperationException.class, () -> SmbEnumerationUtil.doEnum(parent, "*", 0, null, null));
        }

        @Test
        @DisplayName("list propagates SmbUnsupportedOperationException from doEnum")
        void list_propagatesUnsupportedOperationException() throws Exception {
            // Arrange: same setup as above to force doEnum -> SmbUnsupportedOperationException

        verify(treeConnection).ensureDFSResolved(resourceLoc);
    }

    @Test
    @DisplayName("hasCapability delegates and propagates exceptions")
    void hasCapabilityDelegates() throws Exception {
        // Happy path delegates; invalid case propagates SmbException
        when(treeConnection.hasCapability(123)).thenReturn(true);
        assertTrue(handle.hasCapability(123));

        verify(transport).isSigningOptional();
        verify(transport).isSigningEnforced();
    }

    // Error propagation: signing checks may throw SmbException
    @Test
    @DisplayName("signing checks propagate SmbException")
    void signingChecks_throw() throws Exception {
        doThrow(new SmbException("opt error")).when(transport).isSigningOptional();

        assertTrue(filter.accept(smbFile), "Positive size should be accepted");
        verify(smbFile, times(1)).length();
        verifyNoMoreInteractions(smbFile);
    }

    @Test
    @DisplayName("accept: propagates SmbException thrown by dependency")
    void accept_propagatesSmbException() throws Exception {
        // Arrange: filter delegates to isDirectory which may throw SmbException