RAS_CONNECTION_4構造体 (mprapi.h)
接続に関連付けられたユーザー名、ドメイン、グローバル一意識別子 (GUID)、ネットワーク アクセス保護 (NAP) 検疫状態、パケット統計情報、ポイントツーポイント (PPP) およびインターネット キー Exchange バージョン 2 (IKEv2) 関連情報など、接続の特定の情報が含まれます。
構文
typedef struct _RAS_CONNECTION_4 {
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;
FILETIME connectionStartTime;
ULONGLONG ullBytesXmited;
ULONGLONG ullBytesRcved;
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_INFO2 ProjectionInfo;
HANDLE hConnection;
HANDLE hInterface;
DWORD dwDeviceType;
} RAS_CONNECTION_4, *PRAS_CONNECTION_4;
メンバー
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 の場合にのみ有効です。
connectionStartTime
接続開始時刻を UTC で指定する FILETIME 構造体。
ullBytesXmited
接続で送信されるバイト数を示す 値。
ullBytesRcved
接続で受信したバイト数を示す 値。
dwFramesXmited
接続で送信されるフレームの数を示す 値。
dwFramesRcved
接続で受信したフレームの数を示す 値。
dwCrcErr
接続での巡回冗長チェック (CRC) エラーの数を示す 値。
dwTimeoutErr
接続のタイムアウト エラーの数を示す 値。
dwAlignmentErr
接続上の配置エラーの数を示す 値。
dwHardwareOverrunErr
接続でのハードウェア オーバーラン エラーの数を示す 値。
dwFramingErr
接続のフレーミング エラーの数を示す 値。
dwBufferOverrunErr
接続でのバッファー オーバーラン エラーの数を示す 値。
dwCompressionRatioIn
この接続で受信したデータが圧縮される割合を示す 値。 dwCompressionRatioIn メンバーは、圧縮されたデータのサイズを、圧縮されていない状態の同じデータのサイズで割った値です。
dwCompressionRatioOut
この接続で送信されるデータが圧縮される割合を示す 値。 比率は、圧縮されたデータのサイズを、圧縮されていない状態の同じデータのサイズで割った値です。
dwNumSwitchOvers
接続で発生した IKEv2 Mobility および Multihoming Protocol (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_INFO2構造体またはIKEV2_PROJECTION_INFO2構造体を含むPROJECTION_INFO2構造体。
hConnection
RAS 接続へのハンドル。
hInterface
RAS 接続インターフェイスへのハンドル。
dwDeviceType
VPN 接続のトンネルの種類を示す 値。 次の表に、このメンバーに使用できる値を示します。
| 値 | 意味 |
|---|---|
|
ポイントツーポイント トンネル (PPTP) |
|
L2TP トンネル |
|
SSTP トンネル |
|
IKEv2 トンネル |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| Header | mprapi.h |