DeleteIpNetEntry2 函数

DeleteIpNetEntry2 函数删除本地计算机上的邻居 IP 地址条目。

语法

NETIOAPI_API DeleteIpNetEntry2(
  _In_ const MIB_IPNET_ROW2 *Row
);

参数

  • [in]
    指向邻居 IP 地址条目的 MIB_IPNET_ROW2 结构条目的指针。 成功返回后,将删除此条目。

返回值

如果函数成功,DeleteIpNetEntry2 将返回STATUS_SUCCESS。

如果函数失败,DeleteIpNetEntry2 返回以下错误代码之一:

返回代码 描述
STATUS_INVALID_PARAMETER

将无效参数传递给函数。 如果在 参数中传递了 NULL 指针,则返回此错误。 地址MIB_IPNET_ROW2 结构的成员, 参数指向的成员未设置为有效的邻居 IPv4 或 IPv6 地址,或者未指定 InterfaceLuidInterfaceIndex MIB_IPNET_ROW2 成员。

STATUS_NOT_FOUND

找不到指定的接口。 如果函数找不到 InterfaceLuidInterfaceIndex 参数指向的MIB_IPNET_ROW2结构的成员指定的网络接口,则返回此错误。

STATUS_NOT_SUPPORTED

不支持该请求。 如果没有 IPv4 堆栈位于本地计算机上,并且MIB_IPNET_ROW2结构 参数指向的 地址 成员中指定了 IPv4 地址,或者 地址 成员中指定了 IPv6 地址,则返回此错误。

其他

使用 FormatMessage 函数获取返回的错误的消息字符串。

言论

DeleteIpNetEntry2 函数用于删除 MIB_IPNET_ROW2 结构条目。

在输入时,驱动程序必须初始化 参数指向的MIB_IPNET_ROW2结构的以下成员。

  • 地址
    设置为有效的邻居 IPv4 或 IPv6 地址和系列。

  • InterfaceLuidInterfaceIndex
    这些成员按前面列出的顺序使用。 因此,如果指定了 InterfaceLuid,则使用此成员来确定接口。 如果未为 InterfaceLuid 成员设置值(此成员的值设置为零),则接下来使用 InterfaceIndex 成员来确定接口。

在输出中,调用成功后,DeleteIpNetEntry2 删除邻居 IP 地址。

驱动程序可以调用 GetIpNetTable2 函数来枚举本地计算机上的邻居 IP 地址条目。

要求

目标平台

通用

版本

在 Windows Vista 和更高版本的 Windows作系统中可用。

页眉

Netioapi.h (包括 Netioapi.h)

图书馆

Netio.lib

IRQL

< DISPATCH_LEVEL

另请参阅

CreateIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2

SetIpNetEntry2