ルーター管理機能について
次のセクションでは、さまざまな種類のルーター管理機能と、それらを効果的に使用するために知っておくべきことを説明します。
すべてのルーター管理機能には管理者特権が必要です。 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 関数を呼び出してハンドルを取得します。