了解路由器管理功能

以下部分介绍不同类型的路由器管理功能，以及有效使用这些功能应了解的内容。

所有路由器管理功能都需要管理员权限。 Power User 组中的用户没有足够的权限来使用路由器管理功能。

路由器管理功能的不同类别

路由器管理功能可以分为管理功能和配置功能。 管理功能的前缀为 MprAdmin，配置函数的前缀为 MprConfig。 尽管有命名，但这两组函数都用于路由器管理。 MprAdmin 函数直接在正在运行的路由器上运行。 MprConfig 函数具有类似的功能，但对存储在注册表中的路由器配置进行操作。 这两种类型的函数都传递 信息块。

还可以根据路由器管理哪些组件（接口、路由器管理器或路由器管理器客户端）划分路由器管理功能。

路由器接口函数的前缀为 MprAdminInterface 或 MprConfigInterface。 使用这些函数访问接口。 路由器管理器函数的前缀为 MprAdminTransport 或 MprConfigTransport。 使用这些函数访问路由器管理器。 最后， 路由器管理器客户端函数 的前缀为 MprAdminInterfaceTransport 或 MprConfigInterfaceTransport。 使用这些函数访问路由器上运行的客户端。

MprAdmin 函数的子集是 MprAdminMib 函数。 这些也单独在运行路线上运行。 但是，这些函数不会传递信息块。 这些函数为协议设计器提供了额外的灵活性，尤其是在检索非配置信息（如统计信息）时。

确保更改立即发生并且是永久性的

开发人员可以直接使用路由器配置 函数更改路由器配置。 但是，在重启路由器之前，对配置所做的任何更改都不会生效，因为这是 DIM 从注册表中读取配置的唯一时间。

开发人员可以使用路由器管理功能对正在运行的 路由器进行更改。 但是，这些更改不是永久性的：由于它们尚未写入注册表，因此如果重启路由器，它们将丢失。

为了进行即时和持久的更改，开发人员需要同时使用路由器管理和路由器配置功能。 如果路由器未运行，开发人员只需调用相应的路由器配置函数。

若要从正在运行的路由器查询信息，请使用路由器管理功能。 如果路由器未运行，请使用路由器配置函数查询信息。

MprAdminInterfaceCreate 和 MprAdminInterfaceSetInfo 函数支持 MPR_INTERFACE_2 结构。 但是， MprConfigInterfaceCreate 和 MprConfigInterfaceSetInfo 不会。 若要创建一个在重启后持久存在的请求拨号接口，请使用 MPR_INTERFACE_2 调用 MprAdminInterfaceCreate，然后使用 MPR_INTERFACE_0 或 MPR_INTERFACE_1 调用 MprConfigInterfaceCreate。 同样，若要对请求拨号接口进行持久更改，请使用 MPR_INTERFACE_2 调用 MprAdminInterfaceSetInfo，然后使用 MPR_INTERFACE_0 或 MPR_INTERFACE_1 调用 MprConfigInterfaceSetInfo。

远程使用路由器管理和配置函数

大多数路由器管理和配置功能都可以在所管理的计算机以外的计算机上调用。 这些函数将 作为参数、路由器服务的句柄或要管理的配置。 管理功能使用 RPC (远程过程调用) 与句柄指定的路由服务进行通信。 配置函数向句柄指定的计算机的注册表进行写入和读取。

若要管理远程计算机上的路由服务，请先调用 MprAdminIsServiceRunning 来验证该服务是否正在运行。 然后调用 MprAdminServerConnect 以获取句柄。 如果路由器服务未在远程计算机上运行，则 MprAdmin) 调用的所有路由器管理 (失败。

若要更改远程计算机上的路由器配置，请通过调用 MprConfigServerConnect 函数获取句柄。