GetIpInterfaceEntry 函数
GetIpInterfaceEntry 函数检索本地计算机上指定接口的 IP 信息。
语法
NETIOAPI_API GetIpInterfaceEntry(
_Inout_ PMIB_IPINTERFACE_ROW Row
);
参数
- 行 [in， out]
指向 MIB_IPINTERFACE_ROW 结构的指针，该结构在成功返回时接收本地计算机上的接口的信息。 输入时，驱动程序必须将 MIB_IPINTERFACE_ROW 的 InterfaceLuid 成员或 InterfaceIndex 成员设置为要检索其信息的接口。
返回值
如果函数成功，GetIpInterfaceEntry 将返回STATUS_SUCCESS。
如果函数失败， GetIpInterfaceEntry 将返回以下错误代码之一：
| 返回代码 | 说明 |
|---|---|
| STATUS_INVALID_PARAMETER | 向该函数传递了无效参数。 如果在 Row 参数中传递 NULL 指针，Row 参数指向的 MIB_IPINTERFACE_ROW 结构的 Family 成员未指定为 AF_INET 或 AF_INET6，或者未指定 MIB_IPINTERFACE_ROW 结构的 InterfaceLuid 和 InterfaceIndex 成员，则返回此错误。 |
| STATUS_NOT_FOUND | 找不到指定的接口。 如果函数找不到由 Row 参数指向的 MIB_IPINTERFACE_ROW 结构的 InterfaceLuid 或 InterfaceIndex 成员指定的网络接口，则返回此错误。 |
| 其他 | 使用 FormatMessage 函数获取返回错误的消息字符串。 |
注解
输入时，驱动程序必须初始化 Row 参数指向的MIB_IPINTERFACE_ROW结构的以下成员。
系列
设置为 AF_INET 或 AF_INET6。InterfaceLuid 或 InterfaceIndex
这些成员按前面列出的顺序使用。 因此，如果指定 了 InterfaceLuid ，则使用此成员来确定接口。 如果没有为 InterfaceLuid 成员设置值， (此成员的值已设置为零) ，则接下来将使用 InterfaceIndex 成员来确定接口。
在输出时， GetIpInterfaceEntry 填充 Row 参数指向的MIB_IPINTERFACE_ROW结构的剩余成员。
驱动程序必须使用 InitializeIpInterfaceEntry 函数使用默认值初始化MIB_IPINTERFACE_ROW结构条目的字段。 然后，驱动程序可以更改要修改的MIB_IPINTERFACE_ROW条目中的字段，然后调用 SetIpInterfaceEntry 函数。
对具有不同安全要求的多个网络的无特权同时访问会创建一个安全漏洞，并使无特权驱动程序能够在两个网络之间意外地中继数据。 一个典型示例是同时访问虚拟专用网络 (VPN) 和 Internet。 Windows Server 2003 和 Windows XP 操作系统使用弱主机模型，其中远程访问服务 (RAS) 通过增加其他接口上所有默认路由的路由指标来阻止此类同时访问。 因此，所有流量都通过 VPN 接口路由，从而中断其他网络连接。
在 Windows Vista 和更高版本的 Windows 操作系统上，默认使用强主机模型。 如果使用 GetBestRoute2 函数在路由查找中指定了源 IP 地址，则路由查找仅限于源 IP 地址的接口。 RAS 的路由指标修改不起作用，因为潜在路由列表甚至没有 VPN 接口的路由，从而允许流量发往 Internet。 驱动程序可以使用 MIB_IPINTERFACE_ROW 的 DisableDefaultRoutes 成员在接口上使用默认路由来禁用。 当 VPN 客户端不需要拆分隧道时，VPN 客户端可以将此成员用作安全措施来限制拆分隧道。 VPN 客户端可以调用 SetIpInterfaceEntry 函数，以便在需要时将 DisableDefaultRoutes 成员设置为 TRUE 。 VPN 客户端可以通过调用 GetIpInterfaceEntry 函数来查询 DisableDefaultRoutes 成员的当前状态。
要求
目标平台 |
通用 |
版本 |
在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
标头 |
Netioapi.h (包括 Netioapi.h) |
库 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |