RAS_CONNECTION_4 구조체(mprapi.h)
연결과 관련된 사용자 이름, 도메인, GUID(Globally Unique Identifier), NAP(네트워크 액세스 보호) 격리 상태, 패킷 통계, PPP(Point-to-Point) 및 IKEv2(Internet Key Exchange 버전 2) 관련 정보를 포함하는 연결에 대한 특정 정보를 포함합니다.
구문
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 멤버는 다음 값 중 하나 이상을 포함해야 합니다.
| 값 | 의미 |
|---|---|
|
연결에서 PPP(지점 간 프로토콜)를 사용하고 있습니다. |
|
메신저 서비스는 클라이언트에서 활성 상태이며 MprAdminSendUserMessage 함수를 사용하여 클라이언트로 메시지를 보낼 수 있습니다. |
|
연결은 현재 격리되어 있습니다. 격리에서 연결을 제거하는 방법에 대한 자세한 내용은 MprAdminConnectionRemoveQuarantine을 참조하세요. |
|
연결에서 ARAP(AppleTalk Remote Access Protocol)를 사용하고 있습니다. |
|
연결에서 IKEv2를 사용하고 있습니다. |
|
연결에서 IKEv2를 사용하고 있으며 서버에 연결할 수 없습니다. |
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
이 연결에 대한 인터페이스의 이름을 포함하는 null로 끝나는 유니코드 문자열입니다.
wszUserName[UNLEN + 1]
연결에 로그온한 사용자의 이름을 포함하는 null로 끝나는 유니코드 문자열입니다.
wszLogonDomain[DNLEN + 1]
연결된 사용자가 인증되는 도메인을 포함하는 null로 끝나는 유니코드 문자열입니다.
wszRemoteComputer[NETBIOS_NAME_LEN + 1]
원격 컴퓨터의 이름을 포함하는 null로 끝나는 유니코드 문자열입니다.
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
연결에서 발생한 MOBIKE(IKEv2 Mobility and Multihoming Protocol) 스위치의 수를 지정하는 값입니다. dwNumSwitchOvers 멤버는 dwConnectionFlags 멤버가 RAS_FLAGS_IKEV2_CONNECTION 경우에만 유효합니다.
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
연결에 있는 원격 컴퓨터의 IP 주소를 포함하는 null로 끝나는 유니코드 문자열입니다. 이 문자열은 "a.b.c.d" 형식입니다.
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
연결에 있는 로컬 컴퓨터의 IP 주소를 포함하는 null로 끝나는 유니코드 문자열입니다. 이 문자열은 "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 [데스크톱 앱만 해당] |
| 머리글 | mprapi.h |