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 関数を使用してユーザー アカウント サーバーの名前を取得します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| クライアント サポートの終了 |
Windows XP |
| サーバー サポートの終了 |
Windows Server 2003 |
| ヘッダー |
|