RAS_PORT_1構造体

[このバージョンの RAS_PORT_1 構造は、Windows Vista ではサポートされていません。 代わりに mprapi.h で定義されている新しい RAS_PORT_1 を使用してください。]

RAS_PORT_1構造体には、RAS ポートに関する情報が含まれています。

構文

typedef struct _RAS_PORT_1 {
  RAS_PORT_0                rasport0;
  DWORD                     LineCondition;
  DWORD                     HardwareCondition;
  DWORD                     LineSpeed;
  WORD                      NumStatistics;
  WORD                      NumMediaParms;
  DWORD                     SizeMediaParms;
  RAS_PPP_PROJECTION_RESULT ProjResult;
} RAS_PORT_1, *PRAS_PORT_1;

メンバー

rasport0

ポート の名前 、ポートに接続されているリモート ユーザーの名前など、ポートに関する情報を含むRAS_PORT_0構造体を指定します。

LineCondition

ポートの状態を指定します。 このメンバーには、次のいずれかの値を指定できます。

説明
RAS_PORT_NON_OPERATIONAL
ポートが動作していません。 サーバーによって報告されたエラーがないか、イベント ログを確認します。
RAS_PORT_DISCONNECTED
ポートは現在切断されています。
RAS_PORT_CALLING_BACK
RAS サーバーは RAS クライアントを呼び戻しています。
RAS_PORT_LISTENING
ポートは、クライアントがを呼び出すのを待機しています。
RAS_PORT_AUTHENTICATING
サーバーは、リモート クライアントの認証処理中です。
RAS_PORT_AUTHENTICATED
リモート クライアントが認証されました。
RAS_PORT_INITIALIZING
ポートに接続されているデバイスが初期化されています。 初期化が完了すると、ポートの状態は RAS_PORT_LISTENING に変わります。

HardwareCondition

ポートに接続されているデバイスの状態を示すために、次のいずれかの値を指定します。

説明
RAS_MODEM_OPERATIONAL
このポートに接続されているモデムは動作可能であり、クライアント呼び出しを受信する準備ができています。
RAS_MODEM_HARDWARE_FAILURE
このポートに接続されているモデムにハードウェアの問題があります。

LineSpeed

コンピューターがポートと通信できる速度を 1 秒あたりのビット数で指定します。

NumStatistics

このメンバーは使用されません。 RAS 管理関数 ( RasAdminPortGetInfo 関数など) は、 RAS_PORT_STATISTICS 構造体を使用してポート統計を返します。

NumMediaParms

このポートのメディア固有パラメーターの数を指定します。 シリアル メディアの場合、これは通常、SERIAL.INI ファイルに表示される値の数です。

SizeMediaParms

すべてのメディア固有パラメーターに必要なバッファーのサイズをバイト単位で指定します。 RasAdminPortGetInfo 関数は、ポートのメディア パラメーターと値を含むRAS_PARAMETERS構造体の配列を含むバッファーを返します。

ProjResult

このポートの PPP プロジェクション情報を指定する RAS_PPP_PROJECTION_RESULT 構造体。 この構造体は、RAS クライアントがサーバーに接続するときにネゴシエートされる各プロトコルの情報を提供します。

要件

要件
サポートされている最小のクライアント
Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows 2000 Server [デスクトップ アプリのみ]
クライアント サポートの終了
Windows XP
サーバー サポートの終了
Windows Server 2003
ヘッダー
Rassapi.h

関連項目

リモート アクセス サービス (RAS) の概要

RAS サーバー管理の構造

RAS_PARAMETERS

RAS_PORT_0

RAS_PORT_STATISTICS

RAS_PPP_PROJECTION_RESULT

RasAdminAcceptNewConnection

RasAdminConnectionHangupNotification

RasAdminPortGetInfo