CreateIpNetEntry2 函数

CreateIpNetEntry2 函数在本地计算机上创建新的邻居 IP 地址条目。

语法

NETIOAPI_API CreateIpNetEntry2(
  _In_ const MIB_IPNET_ROW2 *Row
);

参数

  • [in]
    指向 IP 路由条目 MIB_IPNET_ROW2 结构条目的指针。

返回值

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

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

返回代码 说明
STATUS_INVALID_PARAMETER

向该函数传递了无效参数。 如果发生以下项之一,则返回此错误:

  • 在 Row 参数中传递 NULL 指针。

  • Row 参数指向的 MIB_IPNET_ROW2 结构的 Address 成员未设置为有效的单播、任意广播或多播 IPv4 或 IPv6 地址。

  • MIB_IPNET_ROW2 结构的 PhysicalAddressPhysicalAddressLength 成员未设置为有效的物理地址。

  • 未指定 MIB_IPNET_ROW2 结构的 InterfaceLuidInterfaceIndex 成员。

  • 在 Address 成员中传递了环回 地址

STATUS_NOT_FOUND

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

STATUS_NOT_SUPPORTED

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

ERROR_OBJECT_ALREADY_EXISTS

该对象已经存在。 如果 Row 参数指向的 MIB_IPNET_ROW2 结构的 Address 成员是接口上由 MIB_IPNET_ROW2 结构的 InterfaceLuidInterfaceIndex 成员指定的现有相邻 IP 地址的副本,则返回此错误。

其他

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

注解

驱动程序必须初始化 Row 参数指向的 MIB_IPNET_ROW2 结构的以下成员:

  • “地址” 成员设置为有效的单播、任意广播或多播 IPv4 或 IPv6 地址和系列。

  • 将 MIB_IPNET_ROW2 结构中的 PhysicalAddressPhysicalAddressLength 成员设置为有效的物理地址。

  • InterfaceLuidInterfaceIndex 设置为接口的 LUID 或索引值。

InterfaceLuidInterfaceIndex 成员按前面列出的顺序使用。 因此,如果指定了 InterfaceLuid ,则此成员用于确定要添加单播 IP 地址的接口。 如果没有为 InterfaceLuid 成员设置值 (此成员的值设置为零) ,则接下来使用 InterfaceIndex 成员来确定接口。

如果 Row 参数指向的 MIB_IPNET_ROW2 结构的 Address 成员中传递的 IP 地址是接口上现有邻居 IP 地址的副本,则 CreateIpNetEntry2 函数将失败。

要求

目标平台

通用

版本

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

标头

Netioapi.h (包括 Netioapi.h)

Netio.lib

IRQL

< DISPATCH_LEVEL

另请参阅

DeleteIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2

SetIpNetEntry2