enableRouter 函数 (iphlpapi.h)

EnableRouter 函数在本地计算机上打开 IPv4 转发。 EnableRouter 还会递增引用计数,用于跟踪启用 IPv4 转发的请求数。

语法

IPHLPAPI_DLL_LINKAGE DWORD EnableRouter(
  HANDLE     *pHandle,
  OVERLAPPED *pOverlapped
);

parameters

pHandle

指向句柄的指针。 此参数当前未使用。

pOverlapped

指向 OVERLAPPED 结构的指针。 除 hEvent 成员外,此结构的所有成员都应设置为零。 hEvent 成员应包含有效事件对象的句柄。 使用 CreateEvent 函数创建此事件对象。

返回值

如果 EnableRouter 函数成功,则返回值ERROR_IO_PENDING。

如果函数失败,请使用 FormatMessage 获取返回错误的消息字符串。

返回代码 说明
ERROR_INVALID_PARAMETER
其中一个参数无效。 如果 pOverlapped 参数为 NULL,则返回此错误。
其他
使用 FormatMessage 获取返回错误的消息字符串。

注解

EnableRouter 函数特定于 IPv4 转发。 如果调用 EnableRouter 的进程在未调用 UnenableRouter 的情况下终止,系统会减少跟踪启用 IPv4 转发的请求数的引用计数,就像进程调用 了 UnenableRouter 一样。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 iphlpapi.h
Library Iphlpapi.lib
DLL Iphlpapi.dll

另请参阅

CreateEvent

IP 帮助程序函数参考

IP 帮助程序起始页

OVERLAPPED

UnenableRouter