通过

PINTERFACE_STATUS回调函数 (routprot.h)

  • 项目

路由器管理器调用 InterfaceStatus 函数来更改接口的状态。

PINTERFACE_STATUS类型定义指向此回调函数的指针。 InterfaceStatus 是应用程序定义的函数名称的占位符。

语法

PINTERFACE_STATUS PinterfaceStatus;

DWORD PinterfaceStatus(
  [in] ULONG InterfaceIndex,
  [in] BOOL InterfaceActive,
  [in] DWORD StatusType,
  [in] PVOID StatusInfo
)
{...}

parameters

[in] InterfaceIndex

指定要更改的接口的索引。

[in] InterfaceActive

指定接口是否处于活动状态。

[in] StatusType

指定新接口状态。 此参数是以下值之一。

RIS_INTERFACE_ADDRESS_CHANGE

RIS_INTERFACE_ENABLED

RIS_INTERFACE_DISABLED

RIS_INTERFACE_MEDIA_PRESENT

RIS_INTERFACE_MEDIA_ABSENT

[in] StatusInfo

指向 结构的指针，该结构指定适合接口状态类型的信息。 例如，如果 StatusType 参数指定地址更改， 则 StatusInfo 参数指向包含新地址信息（如 IP_ADAPTER_BINDING_INFO）的结构。 此参数可以为 NULL。

返回值

如果函数成功，应NO_ERROR返回值。

如果函数失败，则返回值应为以下错误代码之一。

值 说明
ERROR_CAN_NOT_COMPLETE
 未知故障。
ERROR_INVALID_PARAMETER
 InterfaceIndex 参数无效 (例如，不存在具有该索引) 的接口。
 
 

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 routprot.h

请参阅

AddInterface

DeleteInterface