MPR_INTERFACE_1 结构 (mprapi.h)

MPR_INTERFACE_1结构包含特定路由器接口的配置和状态信息。

语法

typedef struct _MPR_INTERFACE_1 {
  WCHAR                   wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1];
  HANDLE                  hInterface;
  BOOL                    fEnabled;
  ROUTER_INTERFACE_TYPE   dwIfType;
  ROUTER_CONNECTION_STATE dwConnectionState;
  DWORD                   fUnReachabilityReasons;
  DWORD                   dwLastError;
  LPWSTR                  lpwsDialoutHoursRestriction;
} MPR_INTERFACE_1, *PMPR_INTERFACE_1;

成员

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

指向包含接口名称的 Unicode 字符串的指针。

hInterface

接口的句柄。

fEnabled

指定是否启用接口。 如果启用接口,则此值为 TRUE ;如果管理上禁用接口,则此值为 FALSE

dwIfType

指定 接口的类型

dwConnectionState

指定接口的当前状态,例如已连接、断开连接或无法访问。 有关可能状态的列表,请参阅 ROUTER_CONNECTION_STATE

fUnReachabilityReasons

指定一个值,该值表示无法访问接口的原因。 有关可能值的列表,请参阅 不可访问的原因

dwLastError

如果接口无法连接,则指定非零值。

lpwsDialoutHoursRestriction

指向 Unicode 字符串的指针,该字符串指定限制拨出的时间。 此字符串的格式为:

<day><space><time range><space><time range> . . . <NULL><day>. . . <NULL><NULL>

其中,day 是一个数字,对应于一周中的某一天。

数字 含义
0
星期日
1
星期一
2
星期二
3
星期三
4
星期四
5
星期五
6
星期六
 

时间范围采用 HH:MM-HH:MM 格式,使用 24 小时表示法。

上述语法中的字符串 <空间> 表示空格字符。 字符串 <NULL> 表示空字符。

限制字符串以两个连续的 null 字符结尾。

例如:

2 09:00-12:00 13:00-17:30&lt;NULL&gt;4 09:00-12:00 13:00-17:30&lt;NULL&gt;&lt;NULL&gt;

上述字符串将拨出限制为星期二和星期四上午 9:00 到中午 12:00 以及下午 1:00 到下午 5:30。

要求

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

另请参阅

MprAdminInterfaceCreate

MprAdminInterfaceEnum

MprAdminInterfaceGetInfo

ROUTER_CONNECTION_STATE

ROUTER_INTERFACE_TYPE

路由器管理参考

路由器管理结构

无法访问的原因