InitializeIpInterfaceEntry 函数
InitializeIpInterfaceEntry 函数使用默认值初始化 MIB_IPINTERFACE_ROW 结构条目的成员。
语法
VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
_Inout_ PMIB_IPINTERFACE_ROW Row
);
参数
- 行 [in， out]
指向要初始化 的MIB_IPINTERFACE_ROW 结构的指针。 成功返回后，此参数中的字段使用本地计算机上的接口的默认信息进行初始化。
返回值
如果函数成功，InitializeIpInterfaceEntry 将返回STATUS_SUCCESS。
如果函数失败， InitializeIpInterfaceEntry 将返回以下错误代码之一：
| 返回代码 | 说明 |
|---|---|
| STATUS_INVALID_PARAMETER | 向该函数传递了无效参数。 如果在 Row 参数中传递 NULL 指针，则返回此错误 |
| 其他 | 使用 FormatMessage 函数获取返回错误的消息字符串。 |
注解
在输出时，将初始化 Row 参数指向的 MIB_IPINTERFACE_ROW 结构的成员，如下所示。
系列
设置为 AF_UNSPEC。InterfaceLuid
设置为未指定的值。所有其他成员
设置为零。
驱动程序必须使用 InitializeIpInterfaceEntry 函数使用默认值初始化MIB_IPINTERFACE_ROW结构条目的字段。 然后，驱动程序可以更改要修改的MIB_IPINTERFACE_ROW条目中的字段，然后调用 SetIpInterfaceEntry 函数。
要求
目标平台 |
通用 |
版本 |
在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
标头 |
Netioapi.h (包括 Netioapi.h) |
库 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |