RAS_CONNECTION_EX構造体 (mprapi.h)
RAS_CONNECTION_EX構造体には、接続に関連付けられたユーザー名、ドメイン、グローバル一意識別子 (GUID)、ネットワーク アクセス保護 (NAP) 検疫状態、パケット統計情報、ポイント対ポイント (PPP) とインターネット キー Exchange バージョン 2 (IKEv2) 関連情報など、接続に固有の情報が含まれます。
RAS_CONNECTION_EX構造体には、RAS_CONNECTION_0、RAS_CONNECTION_1、RAS_CONNECTION_2、RAS_CONNECTION_3結合構造体と同じ情報の大部分が含まれています。
構文
typedef struct _RAS_CONNECTION_EX {
MPRAPI_OBJECT_HEADER Header;
DWORD dwConnectDuration;
ROUTER_INTERFACE_TYPE dwInterfaceType;
DWORD dwConnectionFlags;
WCHAR wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1];
WCHAR wszUserName[UNLEN + 1];
WCHAR wszLogonDomain[DNLEN + 1];
WCHAR wszRemoteComputer[NETBIOS_NAME_LEN + 1];
GUID guid;
RAS_QUARANTINE_STATE rasQuarState;
FILETIME probationTime;
DWORD dwBytesXmited;
DWORD dwBytesRcved;
DWORD dwFramesXmited;
DWORD dwFramesRcved;
DWORD dwCrcErr;
DWORD dwTimeoutErr;
DWORD dwAlignmentErr;
DWORD dwHardwareOverrunErr;
DWORD dwFramingErr;
DWORD dwBufferOverrunErr;
DWORD dwCompressionRatioIn;
DWORD dwCompressionRatioOut;
DWORD dwNumSwitchOvers;
WCHAR wszRemoteEndpointAddress[MAXIPADRESSLEN + 1];
WCHAR wszLocalEndpointAddress[MAXIPADRESSLEN + 1];
PROJECTION_INFO ProjectionInfo;
HANDLE hConnection;
HANDLE hInterface;
} RAS_CONNECTION_EX, *PRAS_CONNECTION_EX;
メンバー
Header
RAS_CONNECTION_EX構造体のバージョンを指定するMPRAPI_OBJECT_HEADER構造体。
dwConnectDuration
接続の継続時間を表す値 (秒単位)。
dwInterfaceType
接続インターフェイスの種類を識別する ROUTER_INTERFACE_TYPE 列挙体。
dwConnectionFlags
接続属性を指定するフラグのビットマップ。 dwConnectionFlags には、 次の値のうち少なくとも 1 つを含める必要があります。
| 値 | 意味 |
|---|---|
|
接続はポイントツーポイント プロトコル (PPP) を使用しています。 |
|
メッセンジャー サービスはクライアントでアクティブであり、 メッセージは MprAdminSendUserMessage を使用してクライアントに送信できます。 |
|
接続は現在検疫中です。 検疫から接続を削除する方法については、 MprAdminConnectionRemoveQuarantine を参照してください。 |
|
接続は AppleTalk リモート アクセス プロトコル (ARAP) を使用しています。 |
|
接続で IKEv2 を使用しています。 |
|
接続で IKEv2 が使用されており、サーバーに到達できません。 |
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
この接続のインターフェイスの名前を含む null で終わる Unicode 文字列。
wszUserName[UNLEN + 1]
接続にログオンしたユーザーの名前を含む null で終わる Unicode 文字列。
wszLogonDomain[DNLEN + 1]
接続されているユーザーが認証されるドメインを含む null で終わる Unicode 文字列。
wszRemoteComputer[NETBIOS_NAME_LEN + 1]
リモート コンピューターの名前を含む null で終わる Unicode 文字列。
guid
接続を識別する GUID。 受信接続の場合、この GUID は接続がアクティブである限り有効です。
rasQuarState
接続の NAP 検疫状態を指定する RAS_QUARANTINE_STATE 構造体。
probationTime
接続が検疫から抜け出すのに必要な時間を指定する FILETIME 構造体。その後、接続が削除されます。 この値は、 rasQuarState の値 が RAS_QUAR_STATE_PROBATION の場合にのみ有効です。
dwBytesXmited
接続で送信されるバイト数を指定する値。
dwBytesRcved
接続で受信したバイト数を指定する値。
dwFramesXmited
接続で送信されるフレームの数を指定する値。
dwFramesRcved
接続で受信したフレームの数を指定する値。
dwCrcErr
接続での循環冗長チェック (CRC) エラーの数を指定する値。
dwTimeoutErr
接続のタイムアウト エラーの数を指定する値。
dwAlignmentErr
接続の配置エラーの数を指定する値。
dwHardwareOverrunErr
接続上のハードウェア オーバーラン エラーの数を指定する値。
dwFramingErr
接続のフレーミング エラーの数を指定する値。
dwBufferOverrunErr
接続でのバッファー オーバーラン エラーの数を指定する値。
dwCompressionRatioIn
この接続で受信したデータが圧縮される割合を指定する値。 dwCompressionRatioIn は、圧縮されたデータのサイズを、非圧縮状態の同じデータのサイズで割った値です。
dwCompressionRatioOut
この接続で送信されるデータの圧縮率を指定する値。 比率は、圧縮されたデータのサイズを、非圧縮状態の同じデータのサイズで割った値です。
dwNumSwitchOvers
RFC4555 で定義されている接続で発生した IKEv2 モビリティおよびマルチホーム プロトコル (MOBIKE) スイッチの数を指定する値。 dwNumSwitchOvers は、 dwConnectionFlags が RAS_FLAGS_IKEV2_CONNECTIONされている場合にのみ有効です。
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
接続内のリモート コンピューターの IP アドレスを含む null で終わる Unicode 文字列。 この文字列は "a.b.c.d" 形式です。
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
接続内のローカル コンピューターの IP アドレスを含む null で終わる Unicode 文字列。 この文字列は "a.b.c.d" 形式です。
ProjectionInfo
PPP_PROJECTION_INFOまたはIKEV2_PROJECTION_INFO構造体を含むPROJECTION_INFO構造体。
hConnection
RAS 接続へのハンドル。
hInterface
RAS 接続インターフェイスへのハンドル。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| ヘッダー | mprapi.h |