RAS_PORT_0構造体

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

RAS_PORT_0構造体には、RAS ポートを記述する情報が含まれています。

構文

typedef struct _RAS_PORT_0 {
  WCHAR wszPortName[RASSAPI_MAX_PORT_NAME];
  WCHAR wszDeviceType[RASSAPI_MAX_DEVICETYPE_NAME];
  WCHAR wszDeviceName[RASSAPI_MAX_DEVICE_NAME];
  WCHAR wszMediaName[RASSAPI_MAX_MEDIA_NAME];
  DWORD reserved;
  DWORD Flags;
  WCHAR wszUserName[UNLEN + 1];
  WCHAR wszComputer[NETBIOS_NAME_LEN];
  DWORD dwStartSessionTime;
  WCHAR wszLogonDomain[DNLEN + 1];
  BOOL  fAdvancedServer;
} RAS_PORT_0, *PRAS_PORT_0;

メンバー

wszPortName

"COM1" など、ポートの名前を指定する null で終わる Unicode 文字列。

wszDeviceType

モデムや ISDN など、接続が確立されたデバイスの種類を指定する null で終わる Unicode 文字列。 このメンバーで指定できるデバイスの種類の一覧には、サード パーティ製デバイスを含め、サーバーにインストールされているすべてのデバイスの種類が含まれます。

wszDeviceName

"Hayes 9600" や "PCIMACISDN1" など、接続が確立されたデバイスの名前を指定する null で終わる Unicode 文字列。

wszMediaName

接続に使用されるメディアの名前 ( rasser や rastapi など) を指定する null で終わる Unicode 文字列を指定します。

reserved

予約済み。

Flags

このポートで行われる接続の性質を指定するビット フラグのセットを指定します。 このメンバーは、次のフラグの組み合わせにすることができます。

値	説明
GATEWAY_ACTIVE	このフラグが設定されている場合、NetBIOS ゲートウェイはサーバー上でアクティブになります。
MESSENGER_PRESENT	このフラグが設定されている場合、messenger サービスはリモート クライアントで実行されています。
PORT_MULTILINKED	このフラグが設定されている場合、ポートは他のポートとマルチリンクされます。 この情報を使用して、接続状態をマルチリンク ポートとして表示します。 マルチリンク ポートの場合、 RAS_PORT_STATISTICS 構造体には、ポート専用とマルチリンク接続の結合ポートの 2 つの統計セットが含まれます。
PPP_CLIENT	このフラグが設定されている場合、リモート クライアントは PPP を使用して接続されます。 このフラグが設定されていない場合、リモート クライアントは AMB プロトコルを使用して接続されます。
REMOTE_LISTEN	このフラグが設定されている場合、NetBIOS ゲートウェイの RemoteListen パラメーターはサーバー上で 1 に設定されます。
USER_AUTHENTICATED	このフラグを設定すると、リモート クライアントがサーバーに接続され、ユーザーが認証されます。 クライアントが実際にポートに接続されていることを確認するには、このフラグを確認します。

MESSENGER_PRESENT、GATEWAY_ACTIVE、およびREMOTE_LISTENフラグが設定されている場合は、messenger サービスを使用して管理メッセージをリモート クライアントに送信します。 MESSENGER_PRESENTとREMOTE_LISTENが設定されていても、GATEWAY_ACTIVEが設定されていない場合は、クライアントが接続されている RAS サーバーからのみメッセージをクライアントに送信します。

wszUserName

このポートに接続されているリモート ユーザーの名前を指定する、null で終わる Unicode 文字列。

wszComputer

リモート クライアント コンピューターの名前を指定する null で終わる Unicode 文字列。

dwStartSessionTime

クライアントがこのポートの RAS サーバーに接続した 1970 年 1 月 1 日からの時間を秒単位で指定します。 標準時間関数を使用して、この値を表示用に書式設定します。

wszLogonDomain

リモート ユーザーが認証されたドメインの名前を指定する null で終わる Unicode 文字列を指定します。 この文字列はドメイン名のみであり、"\\" プレフィックスはありません。

fAdvancedServer

このポートに関連付けられている RAS サーバーが Windows 2000 Advanced Server などの高度なサーバーである場合は、0 以外のフラグを指定します。 この情報を使用して、ユーザー アカウント データベースを持つサーバーの名前を確認します。 RAS サーバーが高度なサーバーの場合は、プレフィックス "\\" を wszLogonDomain メンバーに返される名前に連結して、ユーザー アカウント サーバーの名前を取得します。 これは、高度なサーバーの場合、ローカル ログオン ドメイン名がサーバー名と同じであるためです。 RAS サーバーがワークステーションの場合は、 RasAdminGetUserAccountServer 関数を使用してユーザー アカウント サーバーの名前を取得します。

要件

関連項目

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

RAS サーバー管理の構造

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminGetUserAccountServer

RasAdminPortEnum