RAS サーバーとポートの管理について

RAS サーバー管理機能は、指定された RAS サーバーとそのポートに関する情報を取得します。 これらの関数は、指定された RAS サーバー ポートで接続を終了するためにも使用されます。

MprAdminServerGetInfo 関数は、RAS サーバーの構成に関する情報を含むMPR_SERVER_0構造体を返します。 返される情報には、現在接続に使用できるポートの数、現在使用されているポートの数、サーバーのバージョン番号が含まれます。

MprAdminPortEnum 関数は、RAS_PORT_0構造体の配列を取得します。 各構造体には、RAS サーバーで構成されているポートの 1 つに関する情報が含まれています。 各ポートの情報には、次のものが含まれます。

• ポートの名前
• ポートに接続されているデバイスに関する情報
• ポートに関連付けられている RAS サーバーがWindows NT/Windows 2000 Server であるかどうか
• ポートが現在使用されているかどうか、およびポートが使用されている場合は、接続に関する情報

特定の接続で使用されているポートを取得するには、 mprAdminPortEnum を hConnection パラメーターでその接続にハンドルを渡します。 接続へのハンドルを取得するには、 MprAdminConnectionEnum 関数を使用します。 または、 RAS 管理 DLL を実装している場合、 MprAdminAcceptNewConnection 関数と MprAdminAcceptNewConnection2 関数は、接続の確立時に新しい接続ごとにハンドルを受け取ります。

MPrAdminPortGetInfo 関数を呼び出して、RAS サーバー上の指定されたポートに関する追加情報を取得できます。 この関数は 、RAS_PORT_0 構造体とポートの現在の状態に関する追加情報を含む RAS_PORT_1 構造体を返します。 RasAdminPortGetInfo 関数は、ポートに関連付けられているメディア固有のキーの値を記述するRAS_PARAMETERS構造体の配列も返します。 RAS_PARAMETERS構造体では、RAS_PARAMS_FORMAT 列挙の値を使用して、各メディア固有のキーの値の形式を示します。

MprAdminPortGetInfo 関数は、ポート上の現在の接続 (存在する場合) のさまざまな統計カウンターを含むRAS_PORT_STATISTICS構造体も返します。 マルチリンク接続の一部であるポートの場合、 MprAdminPortGetInfo は個々のポートの統計情報と、接続に関係するすべてのポートの累積統計を返します。 MprAdminPortClearStats 関数を使用して、ポートの統計カウンターをリセットできます。 MprAdminPortDisconnect 関数は、使用中のポートを切断します。

MprAdminBufferFree 関数を使用して、MprAdminPortEnum 関数と MprAdminPortGetInfo 関数によって割り当てられたメモリを解放します。 MPrAdminGetErrorString 関数を使用して、RAS サーバー管理 (RasAdmin) 関数のいずれかによって返される RAS エラー コードを記述する文字列を取得します。