JNA调用SetTcpEntry始终返回317，已提权仍报错的问题求助

我正在开发一款测试仿真软件，需要模拟使用专有TCP/IP协议的通信客户端的特定行为。为了模拟连接断开场景，我需要将已建立的客户端socket从连接列表中移除。经过调研，我发现iphlpapi库提供的SetTcpEntry方法可以实现该需求。
我已经通过JNA在Java中完成了该方案的实现，但即便以管理员身份运行仿真软件，SetTcpEntry调用始终返回317。查阅官方文档可知该错误码代表程序未提权运行，但我通过UAC提权手动校验方法确认，程序确实已经处于提权运行状态。
请问是否有人遇到过同类调用问题？该如何解决？如果没有解决方案，是否有其他可以销毁指定socket的实现方式？

实现代码 #

public static boolean killSocket(final IoSession p_ioSession)
{
    LogMF.info(LOGGER, "Attemtping to delete TCP connection {0} - {1}", p_ioSession.getLocalAddress(), p_ioSession.getRemoteAddress());

    final MIB_TCPROW.ByReference entry = new MIB_TCPROW.ByReference();
    entry.dwLocalAddr.setValue(CodecUtil.getInt(CodecUtil.skipOrder(((InetSocketAddress) p_ioSession.getLocalAddress()).getAddress().getAddress())));
    entry.dwLocalPort.setValue(htons(((InetSocketAddress) p_ioSession.getLocalAddress()).getPort()));
    entry.dwRemoteAddr.setValue(CodecUtil.getInt(CodecUtil.skipOrder(((InetSocketAddress) p_ioSession.getRemoteAddress()).getAddress().getAddress())));
    entry.dwRemotePort.setValue(htons(((InetSocketAddress) p_ioSession.getRemoteAddress()).getPort()));
    entry.state.State = MIB_TCP_STATE_DELETE_TCB;
    entry.state.setType("State");

    final int ret = library.SetTcpEntry(entry).intValue();

    if (ret == 0)
    {
        LogMF.info(LOGGER, "TCP connection {0} - {1} marked deleted", p_ioSession.getLocalAddress(), p_ioSession.getRemoteAddress());
        return true;
    }

    switch (ret)
    {
        case ERROR_ACCESS_DENIED:
            LogMF.error(LOGGER, "Failed to delete TCP connection {0} - {1}: Access is denied. Run as administrator.",
                    new Object[] { p_ioSession.getLocalAddress(), p_ioSession.getRemoteAddress() });
            break;
        case ERROR_NOT_SUPPORTED:
            LogMF.error(LOGGER, "Failed to delete TCP connection {0} - {1}: IPv4 is not configured.", new Object[] { p_ioSession.getLocalAddress(), p_ioSession.getRemoteAddress() });
            break;
        case ERROR_INVALID_PARAMETER:
            LogMF.error(LOGGER, "Failed to delete TCP connection {0} - {1}: Invaid function argument", new Object[] { p_ioSession.getLocalAddress(), p_ioSession.getRemoteAddress() });
            break;
        case ERROR_NOT_ELEVATED:
            LogMF.error(LOGGER, "Failed to delete TCP connection {0} - {1}: Running unelevated.", new Object[] { p_ioSession.getLocalAddress(), p_ioSession.getRemoteAddress() });
            break;
        default:
            LogMF.error(LOGGER, "Failed to delete TCP connection {0} - {1}: Unknown error.", new Object[] { p_ioSession.getLocalAddress(), p_ioSession.getRemoteAddress() });
            break;

    }

    return false;
}

错误根因分析 #

返回码317（ERROR_NOT_ELEVATED）并非只有未提权这一种触发场景，Windows系统对SetTcpEntry的调用校验逻辑存在参数错误被误映射为该错误码的情况，结合你的代码，常见触发点如下：

1. JNA结构体映射错误：MIB_TCPROW的内存布局需要和Windows原生定义完全对齐，包括字段顺序、字节长度、对齐规则，只要有一处不匹配，系统就会判定参数非法，部分Windows版本会误返回317而非正确的87（ERROR_INVALID_PARAMETER）错误码。
2. 特权未主动启用：仅以管理员身份运行程序不足够，进程需要主动启用SeDebugPrivilege特权才能操作系统TCP连接表，默认管理员权限的进程不会自动开启该特权。
3. 字节序转换错误：需要确认你的htons实现、CodecUtil.skipOrder方法的转换逻辑是否符合要求：MIB_TCPROW中的端口、IP地址字段均要求使用网络字节序（大端）存储。

修复方案 #

方案1 修复现有调用逻辑 #

• 第一步：调用Windows APIAdjustTokenPrivileges主动启用当前进程的SeDebugPrivilege特权，再执行SetTcpEntry调用。
• 第二步：校验MIB_TCPROW结构体的JNA映射是否和官方定义完全一致，重点确认state字段的长度为4字节，字段顺序严格按照dwState、dwLocalAddr、dwLocalPort、dwRemoteAddr、dwRemotePort排列。
• 第三步：打印所有赋值后的结构体字段值，和netstat -ano输出的对应连接参数做对比，确认IP、端口的字节序转换正确。

方案2 替代实现（推荐，稳定性更高） #

不需要手动处理复杂的系统API调用和结构体映射，直接调用Windows内置的netsh命令实现指定TCP连接销毁：

netsh interface ipv4 delete tcpconnection 本地IP 本地端口 远程IP 远程端口

你可以通过Java的ProcessBuilder执行该命令，只需要进程具备管理员权限即可，适配所有Windows Vista及以上版本系统，调用成功率远高于直接调用SetTcpEntry。

如果是你当前进程自身持有的socket，不需要调用系统级API，直接调用socket对象的close()方法即可主动断开连接。

内容的提问来源于stack exchange，提问作者Sebastian Götz