Основные сведения о функциях управления маршрутизатором

В следующих разделах рассматриваются различные типы функций управления маршрутизаторами и сведения, которые следует знать для их эффективного использования.

Для всех функций управления маршрутизаторами требуются права администратора. Пользователь в группе Power User не имеет достаточных привилегий для использования функций управления маршрутизатором.

Различные классы функций управления маршрутизатором

Функции управления маршрутизаторами можно разделить на функции администрирования и функции конфигурации. Функции администрирования имеют префикс MprAdmin, а функции конфигурации имеют префикс MprConfig. Несмотря на именование, оба набора функций используются для управления маршрутизатором. Функции MprAdmin работают непосредственно на работающем маршрутизаторе. Функции MprConfig имеют аналогичные функции, но работают с конфигурацией маршрутизатора, хранящейся в реестре. Оба типа функций передают информационные блоки.

Функции управления маршрутизаторами также можно разделить на основе компонентов маршрутизатора, которыми они управляют: интерфейсы, диспетчеры маршрутизаторов или клиенты диспетчеров маршрутизаторов.

Функции интерфейса маршрутизатора имеют префикс MprAdminInterface или MprConfigInterface. Используйте эти функции для доступа к интерфейсам. Функции диспетчера маршрутизаторов имеют префикс MprAdminTransport или MprConfigTransport. Используйте эти функции для доступа к диспетчерам маршрутизаторов. Наконец, клиентские функции диспетчера маршрутизаторов имеют префикс MprAdminInterfaceTransport или MprConfigInterfaceTransport. Используйте эти функции для доступа к клиентам, работающим на маршрутизаторе.

Подмножество функций MprAdmin — это функции MprAdminMib. Они также работают только на работающем маршруте. Однако эти функции не передают информационные блоки. Эти функции обеспечивают дополнительную гибкость конструктора протоколов, особенно для получения сведений, не относящихся к конфигурации, таких как статистика.

Обеспечение того, что изменения происходят немедленно и являются постоянными

Разработчик может вносить изменения в конфигурацию маршрутизатора непосредственно с помощью функций конфигурации маршрутизатора. Однако любые изменения, внесенные в конфигурацию, не вступают в силу до перезапуска маршрутизатора, так как это единственный раз, когда DIM считывает конфигурацию из реестра.

Разработчик может вносить изменения в работающий маршрутизатор с помощью функций администрирования маршрутизатора. Однако эти изменения не являются постоянными: так как они не были записаны в реестр, они теряются при перезапуске маршрутизатора.

Чтобы внести изменения, которые являются как немедленными, так и постоянными, разработчик должен использовать функции администрирования маршрутизатора и конфигурации маршрутизатора. Если маршрутизатор не запущен, разработчику нужно только вызвать соответствующие функции конфигурации маршрутизатора.

Для запроса сведений из работающего маршрутизатора используйте функции администрирования маршрутизатора. Если маршрутизатор не работает, запросите сведения с помощью функций конфигурации маршрутизатора.

Функции MprAdminInterfaceCreate и MprAdminInterfaceSetInfo поддерживают структуру MPR_INTERFACE_2 . Однако MprConfigInterfaceCreate и MprConfigInterfaceSetInfo не делают этого. Чтобы создать интерфейс вызова по запросу, который сохраняется после перезагрузки, вызовите MprAdminInterfaceCreate с MPR_INTERFACE_2, а затем вызовите MprConfigInterfaceCreate с MPR_INTERFACE_0 или MPR_INTERFACE_1. Аналогичным образом, чтобы внести постоянные изменения в интерфейс вызова по запросу, вызовите MprAdminInterfaceSetInfo с MPR_INTERFACE_2, а затем вызовите MprConfigInterfaceSetInfo с MPR_INTERFACE_0 или MPR_INTERFACE_1.

Удаленное использование функций администрирования и конфигурации маршрутизатора

Большинство функций администрирования и конфигурации маршрутизатора можно вызывать на компьютере, отличном от администрирования. Эти функции принимают в качестве параметра, дескриптора для службы маршрутизатора или конфигурации для администрирования. Функции администрирования используют RPC (удаленный вызов процедур) для связи со службой маршрутизации, указанной дескриптором. Функции конфигурации записывают и считывают данные из реестра компьютера, указанного дескриптором.

Чтобы администрировать службу маршрутизации на удаленном компьютере, сначала вызовите MprAdminIsServiceRunning , чтобы убедиться, что служба запущена. Затем вызовите MprAdminServerConnect , чтобы получить дескриптор. Если служба маршрутизатора не запущена на удаленном компьютере, все вызовы администрирования маршрутизатора (MprAdmin) завершаются ошибкой.

Чтобы внести изменения в конфигурацию маршрутизатора на удаленном компьютере, получите дескриптор, вызвав функцию MprConfigServerConnect .