RAS_CONNECTION_EX 構造体 (mprapi.h)
RAS_CONNECTION_EX構造体には、接続に関連付けられているユーザー名、ドメイン、およびグローバル一意識別子 (GUID)、ネットワーク アクセス保護 (NAP) 検疫状態、パケット統計情報、ポイント対ポイント (PPP) およびインターネット キー交換バージョン 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 [デスクトップ アプリのみ] |
| Header | mprapi.h |